Кен Коузен 


Кот. Сборник рецептов 


Предметный подход 


Ко т“СоокБоок 


А РгоЫет-Роси$еа Арргоасп 


Кеп Коизеп 


Вейпо * Вооп + ЕатпВат * ЗеБазюро! , Тю МФА 


Кот. Сборник рецептов 


Предметный подход 


Кен Коузен 


Москва, 2021 


УДК 004.43Ко т 
ББК 352.972 


К55 


К55 


Кен Коузен 
Ко й1. Сборник рецептов. Предметный подход / пер. с анг. А.Н. Киселева. — 
М.: ДМК Пресс, 2021. - 220 с.: ил. 


15ВМ 978-5-97060-883-8 


Этот сборник рецептов охватывает широкий спектр тем, с которыми сле- 
дует ознакомиться разработчику, планирующему перейти на язык Кот или 
желающему изучить его более глубоко. В начале книги описывается процесс 
установки и запуска Ко т, затем обсуждаются фундаментальные особенности 
языка. Особое внимание уделено его объектно-ориентированным возможно- 
стям, которые могут показаться необычными разработчикам на других языках. 

Рецепты, собранные в разных главах по тематическому принципу, можно 
изучать в любом порядке, удобном читателю. Они дополняют друг друга, 
и каждый рецепт заканчивается ссылками на другие. Материал удобно струк- 
турирован: за описанием каждой задачи следуют ее решение и развернутое 
обсуждение. 

Издание предназначено для разработчиков, знакомых с объектно-ориентиро- 
ванным программированием, особенно на ]ауа или другом языке, основанном 
на ]УМ. Знание ]ауа предпочтительно, но не обязательно. 


УДК 004.45Ко т 
ББК 32.972 


© 2021 ОМК Ргез$ Аипон2е4 Киз$1ап тап$|аНоп оЁ {те Еп2И$В е@1 оп оЁ Ко СооКБоок 
[5ВМ 9781492046677 © 2020 Кеп Коизеп/ 

ТЬ$ Нап аНоп 1$ ри 1зВе4 апа 5014 Бу регу зюп 0Ё О’ВеШу Меа, Тпс., мусЬ омлл$ ог 
сопёго]$ аП 1120$ го рибП$В апа зеП {Ве зате. 


Все права защищены. Любая часть этой книги не может быть воспроизведена 
в какой бы то ни было форме и какими бы то ни было средствами без письменного раз- 
решения владельцев авторских прав. 


15ВМ (анг.) 978-1-492-04667-7 © 2020 Кеп Коизеп 
[3ВМ (рус.) 978-5-97060-883-8 © Оформление, издание, перевод, ДМК Пресс, 2021 


Оглавление 


Предисловие от издательства.................... ааа 10 
Предисловие ......................................ииииииииииииииниитиниитиниитинииинитиитиниининииния ть 
ВЕЛ ооо баев 12 
Глава 1. Установка и запуск Ко !1........................... линии 19 
1.1. Запуск Кот без локального компилятора.............. чении нииинниьнииинини 19 
1.2. Установка Кот на локальный комиьютер........... инь иииннининьнни 21 
1.3. Компиляция и выполнение кода на Кот из командной строки.......... 25 
1.4. Использование Кот ВЕРГ........... РАЯ... нение нинннииинииннннни 25 
1.5. Запуск сценария на КоЙШо ................ нение ининииинииинниинининиивини тен иниениннния 26 
1.6. Сборка автономного приложения с помощью Стая УМ .......... линии 26 
1.7. Добавление в Ста@е плагина поддержки Кот (синтаксис Стгоо\уу)...... 29 
1.8. Добавление в Ста е плагина поддержки Кот (синтаксис Ко] 11) ....... 32 
1.9. Сборка проектов на Кот с помощью Ста4[е................. ли ииииииининииини 55 
1.10. Использование Мауеп с Ко|11........... линии ини нинниииннинни 35 
Глава 2. Основы Ко т.................... и ииииилиилииилиииииилиитииииилитиилиниилия 57 
2.1. Использование типов с поддержкой значения пи! ......... ини 51 
2.2. Добавление признака поддержки пи! в ]ауа...............ллинииииииииииинининия 40 
2.3. Добавление перегруженных методов для вызова из ]ауа.......... линь 41 
2.4. Явное преобразование типов........... „+... иияненилини 45 
2.5. Вывод чисел в разных системах счисления .......... +... ининиииниииинининиининие 47 
2.6. Возведение числа в степень.......... шине иниининин 49 
2.7. Операторы поразрядного сдвига ........... инь ниииинининиинини 51 
2.8. Использование поразрядных операторов.................инниинининиининььнньньнне 53 
2.9. Создание экземпляров Ра! с помощью \10............... +... ииниииииииинининнинннни 56 


Глава 5. Объектно-ориентированное 


программирование на КоШМ..................................... ини 59 
5.1. Различия между соп5$е и Ман... иене ннииннишиннни 59 
3.2. Создание нестандартных методов чтения и записи свойстВ ............ +... 60 
3.5. Определение классов данных ............ линии нининини ния иененинининини 63 


3.4. Прием создания теневого свойствВа............ ниши ини иинниииинини 66 


6 


. 


*» Оглавление 


5.5. Перегрузка операторов............. линии ини ииняннинние 68 
3.6. Отложенная инициализация с помощью а еш!(.......... ии иииинииииинини 70 
5.7. Использование операторов/безопасного приведения типа, 

ссылочного равенства и «Элвис» для переопределения 


метода едча[$;. корона ВЕ а Взьны 73 
5:8. Создание синглтонаь: ео ааа аЧЬСЫ 75 
3.9. Много шума из ничего: нон 78 
Глава 4. Функциональное программирование .................................. 81 
4.1. Использование Ю]14 в алгоритмах............ +... ииннининия 81 
4.2. Использование функции гедисе для свертки.......... инь или ииининининия 84 
4:5. Хвостоваярекурсия ирак не 86 
Глава 5. Коллекции ...................... лилии 89 
5:1.работа массивами: лье Фо аеоеЕки 89 
5.2. Создание коллекций .......... линии иначе нии нии иненененининини 92 
5.3. Получение представлений только для чтения из существующих 
КОЛЛЕКЦИИ ео о ео ОО ори 94 
5.4. Конструирование ассоциативного массива из коллекции............111+н++.+. 95 
5.5. Возврат значения по умолчанию в случае пустой коллекции................ 96 
5.6. Ограничение значений заданным диапазоном ...............илнииииииниининнния 98 
5.7. Обработка коллекций методом скользящего окна............ линии 99 
5.8. Леструктуризация списков... нение О нОН 101 
5.9. Сортировка по нескольким свойствам............ ини ниииннининниинии 102 
5.10. Определение своего итератора............... +... иииииииииининининииииининнитинии 105 
5.11. Фильтрация элементов коллекций по типам.......... ини 105 
5.12. Преобразование диапазона в прогрессию ............ +... ииининииииииитинии 107 
Глава 6. Последовательности.......................... или Ч 
6.1. Использование ленивых последовательностей.............:..шинининининиинннниь 111 
6.2. Генерирование последовательностей ....................инниииииииниииььнининнннни 113 
6.3. Управление бесконечными последовательностями............ и ьиньньини 115 
6.4. Извлечение значений из последовательности .......... нии ииьининиининининннни 117 
Глава 7. Функции области видимости ........................... линии, 121 
7.1. Инициализация объекта с помощью арр/у после создания.................. 121 
7.2. Использование а[50 для создания побочных эффектов ........... ленин 122 
7.3. Использование функции 1е1 и оператора «Элвис»..............ининьнииииниие 124 
7.4. Использование 1е{ с временными переменными............ +. иинининииининиие 125 
Глава 8. Делегаты в Ко{Ит....................... и илииилилиииииииилииилииилиинниниия 129 
8.1. Реализация композиции делегированием.................. лее ининиииинининнннни 129 


8.2. Использование делегата 1а7у...........--- нии нинининииниинюииниииинитиииищинннния 132 


Оглавление % 7 


8.3. Гарантия неравенства значению пи|.............. нии ииинининнини 155 
8.4. Использование делегатов обзегуа е и уеоаШМЕ ................инининининининнниь 155 
8.5. Использование ассоциативных массивов в роли делегатов ................. 158 
8.6. Создание собственных делегатов и... .. или ини 140 
Глава 9. Тестирование...................711110......илиииниииииииииииинитиииининния 143 
9.1. Настройка жизненного цикла тестового класса ............. 1. чииььньнььььньини 145 
9.2. Использование классов данных в Тестах......... ии иниияиинининииинининнннни 148 
9.3. Использование вспомогательных функций 
с аргументами по умолчанию ................. еее нии нинииии нина 150 
9.4. Повторение тестов пи 5 с разными данными ........... линии ииинининиини 151 
9.5. Использование классов данных 
для параметризации тестов, нью ницы 154 
Глава 10. Ввод и ВЫВОД.......................... и иииииилинииилииииилиииилиниииининния 157 
10.1. Управление ресурсами с помощью И$е ....................лниииииииниининьнинние ОЙ 
10:2 Запись в Файл: ели ааа оси 160 
Глава: 11, Разное: лоно ооньвиааие 163 
11.1. Обработка версии Кощ........... линии иииииниинннни 163 
11.2. Многократное выполнение лямбда-выражения ........... линии 164 
11.3. Исчерпывающая инструкция МТеп........... нии иииннинньние 165 
11.4. Использование функции гер|асе 
с регулярными выражениями ............. 1. и ини 167 
11.5. Преобразование чисел в двоичное представление и обратно............ 169 
11.6. Создание выполняемого класса.......... нии ини ииинииининниинннни 171 
11.7. Измерение прошедшего времени ..*............. ии ииииииинининииининие 174 
11.8. Запуск потоков выполнения ........\....7... нение еинтининни 175 
11.9. Принуждение к завершению реализации с помощью ТОО ............. 178 
11.10. Случайное поведение класса ВапЯо!1............. 1+... иииииииииинии 179 
11.11. Использование специальных символов в именах функций ............. 181 
11.12. Передача исключений в ]а\а ......... ини ининин ние 182 
Глава 12. Фреймворк $риПО.............................ииииииииииииинииининния 185 
12.1. Открытие классов для расширения фреймворком 5рип® .................. 185 
12.2. Хранимые классы данных на Ко|11.......... нь или иииннинннния 188 
12.5. Внедрение зависимостей ............. ини тии тии тивиивнниее 190 
Глава 15. Сопрограммы и структурированная конкуренция......193 
15.1. Выбор функции запуска сопрограмм .......... 1... ииииииииииииииииининни 195 
15.2. Замена азупс/амай на м ИСоткехе.............. нии линии иииннииннния 198 


СЫ О РН 200 


8 *% Оглавление 


15.4. Запуск сопрограмм в пуле потоков ]ауа............. нение иииниининнни 202 
15.5. Отмена сопрограмм............ нии ииининиииннинининииннние 204 
15.6. Отладка сопрограмм орион нь озерная 207 
Предметный указатель ................................... и иииииииииииилииининиия 209 


ОВ 219 


Посвящается Сандре, поддерживавшей меня все это время. 


Твоя доброта, неослабевающая поддержка 
и профессиональные навыки продолжают менять мою жизнь 


Предисловие от издательства 


Отзывы И ПОЖЕЛАНИЯ 


Мы всегда рады отзывам наших читателей. Расскажите нам, что вы думаете об 
этой книге - что понравилось или, может быть, не понравилось. Отзывы важны 
для нас, чтобы выпускать книги, которые будут для вас максимально полезны. 

Вы можете написать отзыв на нашем сайте ммгм.4тКрге$$.сот, зайдя на 
страницу книги и оставив комментарий в разделе «Отзывы и рецензии». Также 
можно послать письмо главному редактору по адресу атКргез@этаП.сот; 
при этом укажите название книги в теме письма. 

Если вы являетесь экспертом в какой-либо области и заинтересованы в на- 
писании новой книги, заполните форму на нашем сайте по адресу ВИр:// 
4тКрге$$.сот/аиПог$/ри И$В_ЪооК/ или напишите в издательство по адресу 
тКрге5$ @21таЙ.сота. 


(Список ОПЕЧАТОК 


Хотя мы приняли все возможные меры для того, чтобы обеспечить высокое 
качество наших текстов, опибки все равно случаются. Если вы найдете ошибку 
в одной из наших книг - возможно, ошибку в основном тексте или программ- 
ном коде, - мы будем очень благодарны, если вы сообщите нам о ней. Сделав 
это, вы избавите других читателей от недопонимания и поможете нам улуч- 
шить последующие издания этой книги. 

Если вы найдете какие-либо ошибки в коде, пожалуйста, сообщите о них 
главному редактору по адресу атКрге;$@эща!.сот, и мы исправим это 
в следующих тиражах. 


НАРУШЕНИЕ АВТОРСКИХ ПРАВ 


Пиратство в интернете по-прежнему остается насущной проблемой. Изда- 
тельство «ДМК Пресс» очень серьезно относится к вопросам защиты автор- 
ских прав и лицензирования. Если вы столкнетесь в интернете с незаконной 
публикацией какой-либо из наших книг, пожалуйста, пришлите нам ссылку на 
интернет-ресурс, чтобы мы могли применить санкции. 

Ссылкунаподозрительные материалы можно прислать по адресу ат Кргез$@ 
этайЙ.сот. 

Мы высоко ценим любую помощь по защите наших авторов, благодаря кото- 
рой мы можем предоставлять вам качественные материалы. 


Предисловие 


Каждые несколько лет появляется революционно новый язык, обещающий из- 
менить подходы к разработке программного обеспечения. Однако такие обе- 
щания редко сбываются. Язык Кот - совсем другое дело. С момента создания 
в2011годуон медленно и почти незаметно прокрался в базы кода по всему миру. 
Разработчики, долго использовавшие ]ауа и неоднократно сталкивавшиеся 
с недостатками этого языка, смогли добавить вкрапления кода на Кот и бла- 
годаря этому уменьшили размер и увеличили мощность своего кода. 

Получив некоторую известность как предпочтительный язык для разработ- 
ки на Апагоа, Кот достиг достаточно высокой степени зрелости, поэтому 
такая книга крайне необходима. Наполненная множеством полезных советов, 
«Кот. Сборник рецептов» начинает с самого начала. Кен последовательно по- 
казывает, как установить Кот и настроить его для использования в проекте. 
Как вызывать код на Ко 11 из ]ауа, выполнять его в браузере и в виде отдельно- 
го приложения. Но книга быстро движется вперед, описывая приемы решения 
задач программирования, с которыми каждый день сталкиваются разработчи- 
ки и архитекторы. 

Тестированию кода на Кот в книге выделен отдельный раздел, однако вы 
увидите, что идея тестирования пронизывает книгу от начала до конца. Тесты 
в книге служат практическими примерами использования языка и позволят 
вам точнее приспособить рецепты к своим потребностям. 

Книга предлагает простую и действенную помощь, которая поможет вам 
продвинуться по пути освоения Кот. Это важное практическое руковод- 
ство по Ко 11, которое должно лежать на рабочем столе каждого разработ- 
чика (реальном или виртуальном). 


Дон Гриффитс (раит СТИ $) и Дэвид Гриффитс (рама спии$), 
авторы книги «Неаа ЕЁ Кот»! 
6 октября 2019 г. 


' Дон Гриффитс, Дэвид Гриффитс. Неа ЕЕ. КоЦит. Питер, 2020. - Прим. перев. 


Вступление 


Добро пожаловать в «Кот. Сборник рецептов»! Общая целькниги - нетолько рас- 
сказать и показать синтаксис и семантику Кот, но также объяснить, когда и по- 
чему следует использовать туили иную особенность. Книга не стремится охватить 
все детали синтаксиса КоШ-и представить исчерпывающий список библиотек, 
но содержит множество практических рецептов решения основных задач и долж- 
на быть понятна даже читателям, лишь поверхностно знакомым с Кот. 

Компания ]е{Вгаш$ активно продвигает в сообщество Кош идею мульти- 
платформенной, нативной разработки и разработки в окружении ]ауа$ сре. 
Но после долгих размышлений было принято решение не включать в книгу ре- 
цепты, демонстрирующие эти направления, потому что все они или находятся 
в стадии бета-тестирования, или имеют низкую скорость внедрения. Как ре- 
зультат книга сосредоточена исключительно на Кот для ]УМ. 

Код всех примеров можно найти в репозитории СИНиьЬ по адресу: ВИрз:// 
эиБиБ.соп/Коизеп/кот-сооКБоок. Он включает оболочку Стае (с файлом 
сборки, написанным на Кот ОЗ[,, разумеется), и все тесты в нем выполняют- 
ся успешно. 

Все примеры кода в книге были скомпилированы и протестированы с обеи- 
ми доступными версиями ]ауа с долгосрочной поддержкой, а именно с ]ауа 8 
и ]а\уа 11. Несмотря на то что технически для ]ауа 8 истек срок службы, эта вер- 
сия по-прежнему пгироко используется в отрасли, поэтому я решил протести- 
ровать примеры кода с ней тоже. На момент написания этой книги текущей 
была версия Кот 1.5.50 и шла работа над версией 1.3.60. Весь код работает 
с обеими версиями, и репозиторий СИНиЬ будет обновляться для поддержки 
самой последней версии Кот. 


Кому АДРЕСОВАНА ЭТА КНИГА 


Эта книга написана для разработчиков, уже знакомых с основами объектно- 
ориентированного программирования, особенно на ]ауа или другом языке, ос- 
нованном на ] УМ. Знание ]ауа пригодится, но не требуется. 

Данная книга, как и любые другие книги рецептов, в большей степени ори- 
ентирована на описание приемов и идиом Кош, чем на исчерпывающее 
описание языка. Это позволяет без оглядки использовать всю широту возмож- 
ностей языка в любом рецепте, но ограничивает пространство для описания 
основ этих возможностей. Каждая глава включает лишь краткое изложение ос- 
новных методов, поэтому если вы имеете лишь смутное представление о том, 
как создавать коллекции, работать с массивами или проектировать классы, то 
не волнуйтесь. Подробное введение в язык вы найдете в справочном онлайн- 
руководстве (БИрз://ко]апе.оге/Чос$/геегепсе), и в книге часто упоминают- 
ся примеры и обсуждения, имеющиеся в нем. 
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Кроме того, в книге часто описываются реализации функций из библиотек 
Кот, чтобы показать, как разработчики языка работают с ним на практике, 
и рассказать, почему что-то делается именно так. Однако наличия у читателя 
предварительных знаний о реализации не ожидается, и вы можете пропускать 
эти детали. 


(СТРУКТУРА КНИГИ 


Эта книга организована в виде сборника рецептов. Каждый рецепт самодо- 
статочен и независим, но многие из них ссылаются на другие рецепты в книге. 
В общем и целом их можно читать в любом порядке. Тем не менее главы орга- 
низованы следующим образом: 


©) 


глава 1 описывает процесс установки и запуска Кот, включая исполь- 
зование оболочки ВЕРГ, работус инструментами сборки, такими как 
Мауеп и Сгае, и использование собственного генератора изображе- 
ний в Сгаа|[; 

глава 2 описывает некоторые фундаментальные возможности и особен- 
ности Кот, такие как типы с поддержкой пи 1, перегрузка операторов 
и преобразование типов, а затем переходит к исследованию некоторых 
малоизвестных вопросов, в том числе работы с операторами поразряд- 
ного сдвига и с функцией расширения фо в классе Ра\г; 

глава 3 основное внимание уделяет объектно-ориентированным воз- 
можностям языка, которые могут показаться неожиданными или не- 
обычными разработчикам на других языках, таким как использование 
ключевого слова сопз*, поддержка свойств, отложенная инициализация 
и ужасный класс №{В\лпд, который гарантированно запутает любого раз- 
работчика на ]ауа; 

глава 4 содержит лишь несколько рецептов, демонстрирующих возмож- 
ности функционального программирования, которые требуют отдельно- 
го объяснения. Идеи функционального программирования рассматри- 
ваются на протяжении всей книги, особенно в рецептах, использующих 
коллекции, последовательности и сопрограммы, но в эту главу включено 
несколько приемов, которые могут показаться необычными и интерес- 
ными; 

глава 5 охватывает массивы и коллекции, представляя в основном не- 
очевидные методы работы с ними, такие как уничтожение коллекций, 
сортировка по нескольким свойствам, построение окна для коллекции 
и создание прогрессий; 

глава 6 описывает, как в. Кот поддерживается «ленивая» обработка 
последовательностей элементов, по аналогии с обработкой потоков 
в /ауа. Рецепты в этой главе демонстрируют создание последователь- 
ностей, получение данных из них и работу с бесконечными последо- 
вательностями; 

глава 7 рассматривает еще одну тему, уникальную для Кот: функции, 
выполняющие блок кода в контексте объекта. Такие функции, как \1е*+, 
арр\у и а\50, играют очень важную роль в Ко 11, и эта глава рассказывает, 
почему их следует использовать, и показывает, как это делать; 
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О глава 8 обсуждает удобную возможность делегирования. Делегирование 
позволяет использовать композицию вместо наследования, и в стан- 
дартной библиотеке самого Кот имеется несколько делегатов, таких 
как Тату, оБзегуа Ле и уефоае; 

О глава 9 охватывает важную тему тестирования, делая основной упор на 
Гари 5. Эта текущая версия Оп прекрасно поддерживает Кот и может 
использоваться для тестирования обычных приложений на Ко и кода 
на Кот в приложениях 5рише ЕгатемготК. В этой главе обсуждается не- 
сколько подходов, упрощающих написание и выполнение тестов; 

О глава 10 включает пару рецептов управления ресурсами. Они демонст- 
рируют приемы работы с файлами, а также использование функции изе, 
которая широко применяется в нескольких контекстах; 

О глава 11 рассматривает темы, которые трудно отнести к какой-то конк- 
ретной категории, в том числе: как получить текущую версию Ко 11, как 
заставить оператор ипеп быть исчерпывающим, даже если он не возвра- 
щает значения, и как использовать функцию гер\асе с регулярными вы- 
ражениями. Здесь также обсуждается функция Т000, класс Вапдопт и неко- 
торые способы интеграции с механизмом исключений в ]ауа; 

О глава 12 затрагивает вопросы'работы с фреймворками 5рипе ЕгатемотК 
и $рИпе Воов, очень дружелюбными, по отношению к Ко 11. Здесь при- 
водятся рецепты, показывающие, как использовать классы Кот в роли 
управляемых Беап-компонентов, как реализовать хранение данных 
с помощью ]РА и как внедрять зависимости; 

О глава 13 посвящена сопрограммам, одной из самых популярных 0со- 
бенностей Ко 1, и основам параллельного и конкурентного програм- 
мирования на этом языке. Рецепты охватывают такие основы, как 
построители и диспетчеры, а также приемы отмены сопрограмм, их 
отладки и использования собственного пула потоков ]ауа для их вы- 
полнения. 


Главы, да и сами рецепты не обязательно читать в каком-либо определен- 
ном порядке. Они действительно дополняют друг друга, и каждый рецепт за- 
канчивается ссылками на другие, но вЫ можете начать читать с любого места 
в книге. Основная цель глав — объединить похожие рецепты, и они построены 
так, что вы можете перепрыгивать между рецептами в произвольном порядке, 
чтобы решить свою задачу, стоящую перед вами в данный момент. 

Специальное примечание для разработчиков на Апаго!а: в настоящее время 
Ко 1 объявлен предпочтительным языком для разработки на Апаго1а, но это 
гораздо более широкий и универсальный язык программирования. Его мож- 
но использовать везде, где применяется ]ауа, и даже шире. В этой книге нет 
специального раздела, посвященного исключительно Апаго1а, и приемы про- 
граммирования на Кот для Апаго!А обсуждаются повсюду. Есть несколько 
конкретных рецептов, связанных с Апаго!а, таких как отмена сопрограмм, 
которые основаны на том факте, что библиотеки Апаго!А широко используют 
Ко 1, но в целом возможности языка, описанные в этой книге, можно исполь- 
зовать где угодно. Есть надежда, что охват языка в более общем плане поможет 
разработчикам для Апаго!4 найти приемы, которые пригодятся им в любых 
других программных проектах. 
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(СОГЛАШЕНИЯ 
В этой книге используются следующие соглашения по оформлению: 


Курсив 

Используется для обозначения новых терминовхадресов ОВ! и электронной 
почты, имен файлов и расширений. 
Моноширинный шрифт 
Применяется для оформления листингов программ и программных элементов 
внутри обычного текста, таких как имена переменных и функций, баз данных, 
типов данных, переменных окружения, инструкций и ключевых слов. 
Моноширинный жирный 
Обозначает команды или другой текст, который должен вводиться пользова- 
телем. 
Моноширинный курсив 


Обозначает текст, который должен замещаться фактическими значениями, 
вводимыми пользователем или определяемыми из контекста. 


Так выделяются советы и предложения. 


Так обозначаются советы, предложения и примечания общего 
характера. 


Так обозначаются предупреждения и предостережения. 


ИспользовднигпрОГРАММНОГО КОДА ПРИМЕРОВ 


Вспомогательные материалы (примеры кода, упражнения ит. д.) доступны для 
загрузки по адресу: В рз://еБиБ.сот/Коизеп/Копт-соокКБоок. 

Данная книга призвана оказать вам помощь в решении ваших задач. 
В общем случае все примеры кода из этой книги вы можете использовать 
в своих программах и в документации. Вам не нужно обращаться в изда- 
тельство за разрешением, если вы не собираетесь воспроизводить сущест- 
венные части программного кода. Например, если вы разрабатываете про- 
грамму и используете в ней несколько отрывков программного кода из 
книги, вам не нужно обращаться за разрешением. Однако в случае продажи 
или распространения примеров из этой книги вам необходимо получить 
разрешение от издательства О’КВеШу. Если вы отвечаете на вопросы, цити- 
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руя данную книгу или примеры из нее, получение разрешения не требуется. 
Но при включении существенных объемов программного кода примеров из 
этой книги в вашу документацию вам необходимо будет получить разреше- 
ние издательства. 

Мы приветствуем, но не требуем добавлять ссылку на первоисточник при 
цитировании. Под ссылкой на первоисточник мы подразумеваем указание ав- 
торов, издательства и [$ВМ. Например: «Кот СооКБбооК у Кеп Коизеп (О’КеШу). 
Соруйей: 2020 Кеп Коизеп, 978-1-492-04667-7». 

За получением разрешения на использование значительных объ- 
емов программного кода примеров из этой книги обращайтесь по адресу 
регт5$1оп5 @огеШу.сот. 


О’ВЕшху ОмимЕ ГЕАВММС 


Вот уже более 40 лет О’'КеШу Меёа (Бир ://отгеШу.сот/) предоставляет техно- 
логии и бизнес-обучение, знания и опыт, помогающие компаниям добиться 
успеха. 

Наше уникальное сообщество экспертов и новаторов делится своими зна- 
ниями и опытом через книги, статьи, конференции, а также нашу платфор- 
му онлайн-обучения. Платформа онлайн-обучения О’КеШу ОпШпе Геагпте 
предлагает доступ к очным курсам, углубленным учебным планам, интерак- 
тивным средам программирования и обширной коллекции текстовых и ви- 
деоматериалов от О’ВеШу и более 200 других издателей. За дополнительной 
информацией обращайтесь по адресу: ВИр://огеШу. сот. 


КАК Сс НАМИ СВЯЗАТЬСЯ 


С вопросами и предложениями, касающимися этой книги, обращайтесь в из- 
дательство: 

О’КеШу Мед1а, пс. 

1005 Стауепешт Н1еБ\гау Моб 

беБазкоро1, СА 95472 

800-998-9938 (США или Канада) 

707-829-0515 (международный и местный) 

707-829-0104 (факс) 


На сайте издательства имеется веб-страница этой книги, где можно най- 
ти список опечаток в тексте, примеры кода и дополнительную информацию. 
Страница доступна по адресу: В рз://огей Ду/коИт-сооКБоок. 

Свои пожелания и вопросы технического характера отправляйте по адресу: 
Боокаие5Ноп$@огеШу.сот. 

Дополнительную информацию о книгах, обучающие курсы, конференции 
и новости вы найдете на вебясайте издательства: Вр ://мгилиг.отеШу.сот. 

Ищите нас в ЕасеБоок: ВИр://РасебоокК.сот/огеШУ. 

Следуйте за нами в Твиттере: пИр://ул(ег.сот/огеШуте( а. 

Смотрите нас на УочТие: Бр :/АммгигуоцеаЪе.сот/отеШуте41а. 
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БлагодаРНОСТИ 


На конференции Соое 1/О в 2017 году компания объявила, что Кот будет 
поддерживаемым языком разработки для Апаго1а. Позднее в том же году Сга- 
Че Гос. - компания, создавшая инструмент сборки Ста е, — объявила, что бу- 
дет поддерживать предметно-ориентированный язык (О5Т,) Ста@е для сбор- 
ки. Оба этих события подтолкнули меня начать исследовать этот язык, и я рад, 
что сделал это. 

Последние несколько лет я регулярно проводил презентации и семинары 
по Кот. Хотя основы языка легко изучить и применить на практике, я был 
впечатлен его глубиной и тем, насколько быстро он перенимает современные 
идеи разработки из других языков, таких как Стооуу или Зса1а. Кот - это син- 
тез многих передовых идей программирования, и я многому научился, углу- 
бившись в исследования перед написанием данной книги. 

В процессе изучения я познакомился со многими активными разработ- 
чиками Кот, включая Дона Гриффитса (Бамп Ст $) и Дэвида Гриф- 
фитса (Ррауе СиНИ$), написавших выдающиеся: книги «Неаа Еиз{Е Апаго!а 
Реуортепф? и «Неаа Ейз+ Кот»; они даже согласились написать преди- 
словие к этой книге. Хади Харрири (На! Нам), технический евангелист 
Те{Вга!л$, регулярно проводит презентации о Кот. Его выступления всегда 
вдохновляют меня уделять время языку, и он оказался настолько любезен, 
что согласился взять на себя труд технического рецензирования для этой 
книги. Я очень благодарен им. 

Билл Флай (ВШ Ну) тоже принял участие в рецензировании книги. Я об- 
щался с ним на платформе О’ВеШу Геагите Р1аогт бесчисленное множест- 
во раз, и он всегда подавал интересные идеи (и задавал сложные вопросы). 
Мой хороший друг Джим Хармон (п Наптоп) помог мне освоить Апаго!а 
много лет назад и всегда был готов ответить на мои вопросы и рассказать 
о том, как Кот используется на практике. Марк Мейнард (МагК Маупага) — 
активный разработчик, который помог мне понять, как Кот взаимодей- 
ствует с фреймворком $рише Егатемо!К, и я очень благодарен ему за это. 
Наконец, неподражаемый Венкат Субраманиам (УепкаЕ Зибтататат), на- 
писавший свою собственную книгу о Кот (озаглавленную «Ргоэтатите 
Кош» и такую же отменную, как и все остальные его книги), любезно согла- 
сился выделить время в своем плотном графике, чтобы помочь мне с моей 
книгой. Я был рад познакомиться со всеми-Моими техническими рецензен- 
тами, и меня впечатляет, сколько времени"и сил они потратили на улучшение 
книги, которую вы сейчас видите. 

Ятакже хочу поблагодарить многих из моихколлег-докладчиков потуру МЕ]5, 
в том числе Нейта Шутту (№же 5спика), Майкла Кардуччи (М!ерае! Сагдисс!), 
Мэтта Стайна (Май 5Ипе), Брайана Слеттена (Вйап З!е(еп), Марка Ричардса 
(Магк Е1сВага$), Пратика Пателя (РтайКк Рае), Нила Форда (Меа1 Рога), Крейга 


Дон Гриффитс и Дэвид Гриффитс. Неаа Ешз. Программирование для Апаго!а. Питер, 
2016. 15ВМ: 978-5-496-02171-5. - Прим. перев. 


$ Дон Гриффитс и Дэвид Гриффитс. Неаа Ее. Кот. Питер, 2020. 1$ВМ: 978-5-4461- 
1535-4. - Прим. перев. 
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Уоллса (Сга1е М/аПз), Раджу Ганди (Каа Сапа), Джонатана Джонсона (]опаап 
]обпзоп) и Дэна Инохоса (Рап «Фе Мап» Н1по]оза), за их постоянные внимание 
и поддержку. Я наверняка пропустил кого-то в этом перечислении, и если это 
действительно так, то уверяю вас, что это было сделано не намеренно. 

Написание книг и преподавание на учебных курсах (моя основная работа) — 
это не коллективная работа. Приятно иметь друзей и коллег, на внимание и со- 
веты которых я могу рассчитывать. 

В создании этой книги приняли участие многие сотрудники О’КеШу Ме а. 
Очень непросто перечислить их всех, поэтому я особо упомяну Зана МакКуэй- 
да (Гап МсОцаде), которого часто ставил в неловкое положение из-за своего 
нерегулярного графика и моего противоречивого характера. Спасибо тебе за 
терпение, понимание и упорный труд над этой книгой. 

Наконец, я хочу выразить всю свою любовь моей жене Джинджер (Сшеег) 
и моему сыну Ксандеру (Хапаег). Без поддержки моей семьи я не стал бы тем, 
кем являюсь сегодня, и этот факт становится для меня все очевиднее с каждым 
годом. Я никогда не смогу выразить, насколько вы оба дороги мне. 


Глава 


Установка 
и запуск Ко Ип 


Рецепты в этой главе помогут вам начать работу с компилятором Ко т из ко- 
мандной строки и в интегрированной среде разработки (Пцщеэтаееа ОРеуор- 
тет Епупоптепф, ФЕ). 


1.1. Здпуск Котим БЕЗ ЛОКАЛЬНОГО КОМПИЛЯТОРА 


Задача 


Опробовать Кот без установки на локальный компьютер, например на 
Срготероок, не поддерживающем такую возможность. 


Решение 


Использовать Кот Р1аузтоипа (Врз://р!ау Ко ]апэ.ог/) - онлайн-песочницу 
для исследования Кот. 


Обсуждение 


КоНт Рауетоипа предлагает простую возможность поэкспериментировать 
с Кот, исследовать его возможности или просто опробовать Кот в систе- 
мах, где отсутствует компилятор этого языка. Эта онлайн-песочница дает до- 
ступ к последней версии компилятора, атакже к веб-редактору, позволяющему 
писать и выполнять свой код. 
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На рис. 1.1 показан скриншот страницы Кот Р]аустоипа в браузере. 


Фо ® в кюнпраудоила х + 
< С а нирз//рау.коНимапа.ога/.. 5 о 4 АФОо тез о уш в ое: 


Ргодгаттта |апдцаде 
{агдеНпа ММ, Апаго, дамазсирЕ апа Мабуе Раудгоипа Ехатр!ез Коап$ 


(у 
ре1пЕТп( 


ЗЕТ 
ВРАМ$ 


© 2000-2018 уе{Вгат$. АП пар гезегуеа Зропзогед апа деуе!ореа Бу 


Рис. 1.1. Домашняя страница Кот Р!аудгоипа 


Просто введите свой код и щелкните на кнопке Кип (Запустить), чтобы вы- 
полнить его. Кнопка 5етод$ (Настройки), со значком шестеренки, позволяет 
изменить версию Кош, выбрать платформу для запуска (УМ, ]$, Сапуаз$ или 
Лай) или добавить аргументы для программы. 


Начиная с версии Ко 1.5, функцию таш можно объявлять без па- 
раметров. 


В разделе Ехатр[ез$ (Примеры) вы найдете множество примеров программ, 
организованных по темам, которые можно выполнять прямо в браузере. 
На рис. 1.2 показана страница с примером программы «НеПо мо». 
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Фо ® вл юипраустоипа х + 
< С О нирз/Ирауконимапо.ого/ьуЕ.. овбАФОоОТФе Ос сош уш ое 
Ргодгатитута 'апдиаде 
1агденпа ММ, Апаго!, дауа$сирЕ апа Мануе Раудгоипа РЯ Коап$ 
—_ Нео мома 
НеНо мой а 
о раскаде огд.Ко{\1п1апд.р\ау // 1 > 
\УамаЫе$ 
Фип та1п() { // 2 
Ми! багеЁу реп п ("Не\Ло, Мог1а!") // 3 
С!а5зе$ } 
бепейс$ 7 Е Ч р . 
1. КоНт сое изцаНу 4ейпеЯ т раскадез. № уси Чоп аейпе опе, {Не 
пвегКапсе 


Че{аи расказе м! Бе изеа. 

у Сопёго! Ео\м 2. Тре тат етгу‘ротЕ {0 а Кот аррИсаНоп {5 а гипсНоп са!еЯ тат 
апа зтсе Кот 1.3 # сап Бе а гипсНоп М/КПоцЕ апу рагате{ег$. 

3. рези п \мтЙез {о ${апЧага оц{ри{ апа 15 иприсШу итроцес; а|50, 

у РипсНопа! по!е {паЁ зеписоюпз аге орНопа!. 

у б{апаага гагу 


у бреса| с!аз5е$ 


Рог КоНт уегзюпз$ еагйег {Вап 1.3 {Не па1п РипсНоп тиз{ Бе аеНпея мВ 


м РгодисН\уКу Бооз{ег$ . 
а рагатетег: 


у РеедаНоп 


АЕ Фип та1п(агд$: Аггау<5$4г1п9>) { > 
рг1п1п("Не11о, Мог1а!") 


Рис. 1.2. Примеры в Кот Р!аудгоипа 


В специальном разделе Коап$ (Задачи) вы найдете серию упражнений, ко- 
торые помогут вам ближе познакомиться с языком. Упражнения доступны 
не только в интернете - если вы используете пе!) ТОЕА или Апаго1а $410, 
то доступ к упражнениям можно получить с помощью плагина ЕдиТоо1$. 


1.2. УстАновкА Котим нАЛОКАЛЬНЫЙ КОМПЬЮТЕР 


Задача 


Получить возможность запускать код на Кот из командной строки на локаль- 
ном компьютере. 


Решение 


Установить компилятор вручную из СИНиВ или воспользоваться диспетчером 
пакетов операционной системы. 
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Обсуждение 


На странице Вир ://ко1апе.оге/аосз/счоа1з/сотлтапа-Нпе.В 7] описывают- 
ся возможные варианты установки комнилятора командной строки. Один из 
вариантов - загрузить 7[Р-файл с программой установки для своей операцион- 
ной системы. На этой странице имеется ссылка на репозиторий СИНиь (йИр5:// 
огей1у/АХахХМ) с текущими версиями Кот. Там вы найдете файлы ИТР с паке- 
тами для Мпих, тасО$, МЛп4о\з и с исходным кодом. Просто разархивируйте 
пакет и добавьте путь к его подкаталогу Вт в переменную окружения РАТН. 

Установить компилятор вручную несложно, но некоторые разработчики 
предпочитают использовать диспетчер пакетов. Диспетчер пакетов автомати- 
зирует процесс установки, а некоторые из них даже позволяют поддерживать 
несколько версий компилятора. 


$ОКМАМ!, $соор и другие диспетчеры пакетов 


ЗОКМАМ! (0ёрз://заКтлап.10/) - одна из самых популярных программ уста- 
новки пакетов. Первоначально она разрабатывалась для командных оболочек 
Ох, но уже есть планы создать версии для других платформ. 

Установка Кот с помощью 5ОКМАМ! начинается с загрузки и установки 
этой программы с использованием сиг\: 


> сиг1 -$ ВЕЁрз: //дее.зЧКмап.1о | Базв 


После установки следует выполнить команду ДК, чтобы установить любой из 
поддерживаемых продуктов, в число которых входит и Кот: 


> 59К Ала. Ко Ап 


По умолчанию устанавливается последняя версия в каталог -/.5Актап/ 
сап@асжез/коНт вместе со ссылкой сиггеп, указывающей на выбранную версию. 
Узнать, какие версии доступны, можно с помощью команды 1151: 


> 5АК 15 Ко Ап 


По умолчанию команда 1п5{а 1 выбирает последнюю версию, но при жела- 
нии ее можно заставить установить конкретную версию: 


> $9К изе Ко{\Ап 1.3.50 


Эта команда установит версию Ко т 1.3.50. 


Пие ШЕА и Апаго!а 5(а1о могут использовать и свою собствен- 
ную, и загруженную версию. 


В числе других диспетчеров пакетов, поддерживающих Кош, можно на- 
звать: Нотебгем (Бр://5теми.5/), МасРог$ (рэ ://мгигиглпасрог($.оге/) и Зпар- 
сгай (В рз://зпарсгаЕ.1о/). 

В МЯпдомз можно использовать 5соор (0 рз://зсоор.$В/). Зсоор играет в МЙп- 
Чо\гз ту же роль, что другие диспетчеры пакетов в системах, отличных от М/т- 
Чомгз. $соор требует наличия в системе Ромег5 Ве! 5 или выше и .МЕТ ЕгатемогК 
4.5 или выше. Инструкции по установке можно найти на сайте 5соор. 


х. 
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После установки 5соор можно установить текущую версию Кот: 


> зсоор 1п$фа 1 Ко Ап 


Эта команда установит сценарии Койт.Ваё, КоНтс.Баё, КоНт-}5.БаЕ и КоНт- 
т.БаЕи добавит путь к ним в переменную окружения РАТН. 

Этого вполне достаточно, но если вы решите поэкспериментировать, попро- 
буйте экспериментальную программу установки Ко Ап-па уе, которая также 
устанавливает собственный компилятор для МИпаом‘з. При этом еще будет уста- 
новлен МУМ-компилятор для Кот, среда выполнения и инструмент генера- 
ции низкоуровневого кода с использованием комплекта инструментов ИУМ. 

Независимо от способа установки Ко т, убедиться в его доступности и ра- 
ботоспособности можно с помощью простой команды Ко Ап -мег5\оп. Вот ти- 
пичный вывод этой команды: 


> Ко Ап -уег$\оп 
Ко11п уег$\1оп 1.3.50-ге\еазе-112 (ВЕ 13+33) 


Смотри также 


Рецепт 1.3, где обсуждается, как использовать Ко т из командной строки после 
установки. 


1.5. Компиляция и ВЫПОЛНЕНИЕ КОДА НА Котим 
ИЗ КОМАНДНОЙ СТРОКИ 


Задача 
Скомпилировать и выполнить код на Кот из командной строки. 


Решение 
Использовать команды Ко А пс- ут и Ко Ап. 


Обсуждение 


Кот $ОК для ]УМ включает команду Ко Апс-)уп вызова компилятора Кот 
и команду Ко Ап выполнения кода на Кот. Они используются подобно ко- 
мандам )ауас и )а\ма в ]ауа. 


Дистрибутив Кот включает сценарий Ко пс-)з для компиляции 
в /ауазсире. В этой книге предполагается использование версии для 
]УМ. Базовый сценарий Ко пс - это псевдоним для Ко Апс- мм. 


Рассмотрим для примера простейшую программу «НеПо, Кот!». Создайте 
файл с именем йеПо.Е и добавьте в него код из примера 1.1. 
Пример 1.1. НеЦо.КЕ 


Кап па\п() { 
ргАп1п(“Не До, Ко 4п!”) 
} 
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Команда Ко Апс скомпилирует этот файл, а команда Ко Ап выполнит полу- 
ченный файл класса, как показано в примере 1.2. 


Пример 1.2. Компиляция и выполнение файла с кодом на Ко{Ип 


> Ко Апс- ум ПеЦо.КЕ © 


> 1$ 
ВеЦо.К& Неоке.с1а$$ [2 


> КоАл НеПокЕ 
Нео, Ко Ап! 


Ф Компиляция исходного кода 
@ Выполнение получившегося файла класса 


Компилятор создаст файл НеПоКЕ. с1а$$ с байт-кодом, который можно выпол- 
нить в виртуальной машине ]ауа. Ко] ш'не тенерирует исходный код на ]ауа — 
это не транспилятор. Он генерирует байт-код, который может интерпретиро- 
ваться виртуальной машиной УМ. 

Скомпилированный класс получает имя, соответствующее имени файла, но 
с первой заглавной буквой, и в конец имени добавляется окончание КЕ. Этим 
поведением можно управлять с помощью аннотаций. 

Чтобы создать автономный файл ]АВ, который можно запустить командой 
}ауа, добавьте аргумент -1пс\иде-гип ме, как показано в примере 1.3. 


Пример 1.3. Включение среды выполнения Ко{Ип 
> Ко Апс-)ум ВеДо.КЕ -1пс1иде-гип ме -9 Вео.)аг 


Эта команда создаст файл йеПо.уаг, который можно запустить командой дауа: 


> ]ама -]аг Вело. )аг 
Нео, Ко Ап! 


Без флага -1пс\иде-гипмескомпилятор создаст ]АК-файл, которому не- 
обходимо, чтобы среда выполнения Кот находилась в пути к классам 
(с1аззраей). 


Команда Ко А пс без аргументов запускает интерактивную оболоч- 
ку Кот ВЕРГ, которая обсуждается в рецепте 1.4. 


Смотри также 


Рецепт 1.4 демонстрирует, как использовать интерактивную оболочку Ко тп 
ВЕРГ, (Веад-Еуа|-Ришп"-Гоор - прочитать, вычислить, вывести и повторить). 
Рецепт 1.5 демонстрирует выполнение сценариев на Кот из командной 
строки. 
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1.4. ИспользоваАниИЕ Котим ВЕРЕ. 


Задача 
Выполнить код на Кот в интерактивной оболочке. 


Решение 
Запустить Кот ВЕРГ, командой Ко*\4пс без аргументов. 


Обсуждение 


Ко 1 включает интерактивную оболочку для работы с компилятором, которая 
называется ВЕРГ, и запускается командой Ко*Апс без аргументов. После запус- 
ка в оболочке ВЕРГ, можно вводить произвольные команды Ко и сразу же 
получать результаты. 


Оболочка Кол ВЕРГ, также доступна в Апаго!а 5410 и Пе] РЕА 
в виде пункта меню То0[5 —> Кот —> Кот КЕРЕ (Инструменты -> 
Кот —> Кот ВЕРГ). 


После запуска команды Ко 1пс вы оказываетесь в интерактивной оболочке. 
В примере 1.4 показан пример сеанса работы в этой оболочке. 


Пример 1.4. Использование оболочки Кот КЕРЁЕ 


> Ко Апс 

Ме\соме фо Кот умег$\оп 1.3.50 (ВЕ 11.0.4+11) 
Туре :Ве\р Рог Не\р, :а\\{ Рог ал 

>>> рп лп(“Не До, Мог19!”) 

Нео, Мог19! 

>>> маг пате = “БоДу” 

>>> реп лп(“Нео, $папе!”) 

Нео, БоДу! 


>>> :Нешр 

Ауа\ДаБЛе соммапдс: 

:ре\р Лом В15 Вер 

: Чите ех1{ {Ве 1пкегрге{ег 

:дитр Бу{есоде дитр с1а5$е$ +0 егтпа\ 
оад <ЕЩе> Тоа4 зсгАре Ргом зрес\Ред Ре 
>>> ‘ЧА 


Оболочка ВЕРГ, позволяет легко и быстро’вычислять выражения Кот без 
запуска ШЕ. Используйте ее в случаях, когда нежелательно создавать проект 
или другую коллекцию файлов в ШЕ и нужно лишь быстро проверить какую- 
то идею, помочь другому разработчику либо если ШЕ вообще отсутствует на 
компьютере. 
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1.5. ЗАПУСК СЦЕНАРИЯ НА Котим 


Задача 
Написать и выполнить сценарий на Кот. 


Решение 


Сохранить код в файле с расширением .КЕ5 и использовать команду Ко Апс с па- 
раметром -$сг\Аре, чтобы запустить его. 


Обсуждение 


Команда Ко Апс поддерживает несколько параметров командной строки. 
Один из них позволяет использовать эту командужак интерпретатор для вы- 
полнения сценариев на Кот. Сценарий - это текстовый файл с исходным 
кодом на Кот и с расширением .Ё(5. 

Для демонстрации в примере 1.5 приводится сценарий в файле 5ои йро[е. 
КЕ5, отображающий текущее время на Южном полюсе и какое время исполь- 
зуется - зимнее или летнее. Сценарий использует пакет }ауа.Нте, добавлен- 
ный в |ауа 8. 


Пример 1.5. зоиНрое.К!5 

1трогЕ )а\а.1ме.* 

уа1 1п${ап{ = Тпзфапе.пои() 

уа\ зоц{НРо{е = 1п5ап*.а{7опе(7опе!19.о{(“Апфагс\са/5оцН_Ро1е”)) 
уа\ 45+ = соц ПРо\е. 7опе.г\ез.15Бау119НЕба\1п9$ (1п5ап{) 


ргап п (“ТЕ 15 ${зоцЕНРоТе. о[оса1ТАме()} (УТС${зоцЕПРое.о{Р5е{}) аф {Не боиЕН Ро\е”) 
ргап п (“ТНе боцЕРА Рофе $414 (495%) “15” е|5е “15$ по{”} оп Бау\9Ве ба\пд$ Т1ме”) 


Запустить этот сценарий можно командой Ко Апс с параметром -зсг\ре: 


> Ко Апс -$сгАрЕ зоцЕПро\е.К{$ 
Г 1$ 10:42:56.056729 (0ТС+13:00) аЁ {Ве боиЕН Ро\е 
Тре боцЕёН Ро|е 15 оп Вау \9ВЕ За\1пд9$ ТАме 


Сценарии содержат код, который обычно помещается в стандартный метод 
ма\п класса. То есть Ко шп можно использовать как язык сценариев для УМ. 


1.6. СБОРКА АВТОНОМНОГО ПРИЛОЖЕНИЯ С ПОМОЩЬЮ 
СКААЕУМ 


Задача 


Создать приложение, которое можно запускать из командной строки без при- 
менения любых дополнительных зависимостей. 


Решение 
Использовать компилятор Стаа!УМ и инструмент па ме-1маде. 


х. 
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Обсуждение 


СтааУМ (Брз://мгиги. отааут.оге/) - это высокопроизводительная виртуаль- 
ная машина с универсальной средой выполнения для запуска приложений, 
написанных на различных языках. Вы можете написать приложение на лю- 
бом языке, основанном на ] УМ, таком как ]ауа или Ко, и интегрировать его 
с программным кодом на ]ауазсирь КиБу, Руоп, К и других языках. 

Одной из замечательных особенностей Сгаа!УМ является возможность ис- 
пользовать ее для создания автономного выполняемого файла. Этот рецепт 
демонстрирует простой способ использования инструмента па уме-\таде из 
Стаа!УМ для создания двоичных файлов из исходного кода на Кот. 

Получить дистрибутив Сгаа!УМ можно по адресу: В рз://оте!. Ду/Оспа7. Для 
разработки текущего рецепта я установил бесплатную версию Соттипйу Еа1- 
Поп с помощью диспетчера пакетов ЗОКМАМ!: 
> $ЧК 1пзфаЦ. дама 19.2.0.1-9г1 
> ]ама -уег5\1оп 
ореп)4К \уег$1оп «1.8.0_222» 


Ореп20К ВипЕме Епу\гопмепЕ (Би\19 1.8.0_222-20190711112007.дгаа\.. )ЧК8и-$гс... 
Ореп20К 64-ВАЕ Сгаа1\М СЕ 19.2.0.1 (Би\19 25.222-608-)утс\-19.2-602, пАхеф поде) 


> ди 1л5аЦ. па{м\е-\маде 
// эта команда установит компонент па{\е-1таде 


Возьмем за основу Ко/т-версию программы «Нео, Мой а!», изображенную 
на рис. 1.1, и воспроизведем ее: 


Рип пафп() { 
рп п (“НеДо, Иог19!”) 
} 


Как отмечалось в рецепте 1.3, этот сценарий легко скомпилировать с по- 
мощью Ко пс- ут, получить файл НеПоКЕ. с1а$$, а затем запустить его коман- 
дой Ко Ап: 
> Ко Апс-)ум ВеДо.КЕ // сгенерирует НеЛоКЕ.с1а$$ 


> КоАп НеДокЕ 
Нео, Мог19! 


Но, чтобы получить автономный выполняемый файл, сначала следует ском- 
пилировать сценарий с параметром -\йе\иде-гип ме и получить файл йеПо.}аг: 


> Ко Апс-)ум ВеЦо.КЕ -4пс1иде-гип ле -9 Вео/Заг 


А потом с помощью инструмента па \е-1маде, входящего в состав Стаа! УМ, 
сгенерировать из него выполняемый файл, как показано в примере 1.6. 


Пример 1.6. Создание автономного выполняемого файла с помощью бгаа[УМ 
> па \\е-1таде -)аг Нео. )аг 


Вот выдержка из документации: «Для компиляции пайуе-птаве ис- 
пользует набор инструментов, установленный локально, поэтому 
в системе должны быть установлены пакеты &1%с-4еуер, =Пь-аеуей 
(с файлами заголовков для библиотеки С и 71) и эсс». 
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В процессе работы эта команда выведет следующие строки: 


> па \\е-1таде -)аг ВеДо. ]аг 

Ви 9 оп Зегуег(р1Ч: 61247, роге: 49590)* 
[Ве10:61247] С1а$$115{: 1,497.63 пз 
[Ве10:61247] (сар): 2,225.47 пз 
[Ве\10:61247] зефир: 3,451.98 м5 
[Ве110:61247]  ({уре ом): 2,163.16 п5 
[Ве10:61247] (оБ]ес{$): 1,793.53 м5 


[Ве110:61247]  (Геафигез): 215.90 м3 
[Ве10:61247] апа1у515: 4,247.68 пз 
[Ве10:61247] (СИп\): 197.96 т5 
[Ве\10:61247] ипт\уегзе: 399.58 т5 
[Ве10:61247] (рагзе): 329.84 т5 
[Ве\10:61247] (иле): 753.12 т5 
[Ве\10:61247] (сотр е): 3,426.14 м5 
[Ве10:61247] сотр е: 4,807.54 м5 
[Ве10:61247] 1таде: 306.96 т5 
[Ве\10:61247] игЦе: 180.22 т5 
[Ве\10:61247] [Еофа\]: 15,246.88 м5 


В результате будет создан файл Нео, который можно запустить из команд- 
ной строки. В Мас или другой Отх-подобной системе для этого достаточно вы- 
полнить команду: 


> ./НеДо 
Нео, Мог19! 


Теперь мы знаем три способа запуска сценариев на Кот: 


О скомпилировать его командой Ко Агпс- мп и затем запустить командой 
Ко п; 

О скомпилировать ] АВ-файл с включением в него среды выполнения и за- 
тем выполнить командой )а\ма; 

О скомпилировать командой Ко Апс, создать двоичный файл с помощью 
Стая УМ и затем выполнить как самую обычную команду. 


Размеры файлов, получаемых в этих трех случаях, сильно различаются. Раз- 
мер скомпилированного файла НеПоКЕ.с1а55 с байт-кодом составляет около 
700 байт. Размер файла ПеПо.;аг с включенной средой выполнения составляет 
около 1,2 Мбайт. Автономный двоичный файл получается еще больше - около 
2,1 Мбайт. Однако разница в скорости выполнения огромна даже для такого 
крошечного сценария, как показано в примере 1.7. 


Пример 1.7. Хронометраж выполнения сценария ПеЦо 


> Име Ко Ап НеокЕ 
Нео, Мог19! 
Ко Ап НеЛокЕ 0.13$ изег 0.055 зузфет 112% сри 0.157 фофа\ 


= [Боситеп{$ /Ко п 

> Име ]ауа -)аг Нео. ]аг 

Нео, Мог19! 

Зауа -)аг Ве\1о.3аг 0.085 изег 90.025 зузфем 99% сри 0.106 Еота| 


х. 
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= [боситеп{$ /Ко п 

> Име ./ВеДо 

Нео, Мог1 9! 

. ео 0.005 изег 0.005 зузфем 59% сри 0.008 тота1 


Результаты весьма показательны. ]АВ-файл выполняется несколько быстрее, 
чем запуск класса командой Ко Ап, но двоичный файл выполняется на порядок 
быстрее. В этом примере для его выполнения потребовалось всего около 8 мил- 
лисекунд. 


Если вы пользуетесь Стае, то можете использовать плагин под- 
держки Сгаа!УМ с названием дгад\е-дгаа\. Он добавит в вашу систе- 
му сборки задачу дгад\&ё-9гаа\ (кроме всего прочего). Подробности 
смотрите на домашней странице (Врз://огей.[у/3зеуЗУ) плагина. 


1.7. ДоБАВЛЕНИЕ В СВАОЕЕ ПЛАГИНА ПОДДЕРЖКИ Котим 
(синтаксис Своо\У) 


Задача 


Добавить в систему сборки СгаМе плагин поддержки Кот, используя син- 
таксис предметно-ориентированного языка (Вотат-бресйс Гапеиаее, О$Т,) 
Стооху. 


Решение 
Добавить в файл сборки зависимость Ко и плагин, используя теги Сгооуу 051. 


Обсуждение 


В этом рецепте используется язык Стооуу ОЗТ, для Ста е. В следую- 
щем рецепте будет показано, как использовать Кот О$Т, для Сгае. 


Инструмент сборки СтаФе (Вр$://отае.оге/) поддерживает компиляцию 
исходного кода на Кот в байт-код]УМ с помощью плагина, предлагаемого 
компанией ]еВга1л$. Плагин Ко Ап-дга\е-р\идлп зарегистрирован в репозито- 
рии плагинов Ста@е и может быть добавлен в сценарий сборки Ста Фе, как пока- 
зано в примере 1.8. Этот код нужно добавить в файл БийАа.етаае в корне проекта. 


Пример 1-8. Добавление плагина поддержки Кот с помощью блока ршад!т$ (бгооуу В$1) 


р\ид\п$ { 
19 «огд. )еБга\п$ Ко Ап. ут» мег$\оп «1.3.50» 
} 


Значение уег5\оп представляет одновременно версию плагина и Кот. 
Ста е все еще поддерживает старый синтаксис добавления плагинов, как по- 
казано в примере 1.9. 
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Пример 1.9. Старый синтаксис добавления плагина поддержки Кот (бгооуу 051) 


Би 9зсгарЕ { 
героз\ог\е$ { 
пауепСеп{га\() 


р 


Черепдепс\е$ { 
СТаззрафВ 'огд. )е{Бга\п$ . Ко п: Ко 11 -дгае-р1и91п:1.3.50' 


} 
} 
р\идлл$ { 

19 «огд. )еБга\п$ Ко Ап. ут» мегз\оп «1:3450» 
} 


В обоих примерах используется синтаксис Стооуу О$Г. для файлов сбор- 
ки Отае, который поддерживает строки в одинарных и в двойных кавычках. 
В языке Сгоо\уу, как и в Кот, строки в двойных кавычках поддерживают ин- 
терполяцию, но здесь этого не требуется, поэтому двойные кавычки можно за- 
менить одинарными. 

Блок р\491п$, в отличие от блока геро5\{ог1ез, не требует указывать мес- 
тоположение плагина. Это верно для любого плагина Стае, зарегистри- 
рованного в репозитории плагинов Сга Ме. Блок р\и91п5 также автоматиче- 
СскиИ «применяет» плагин, поэтому при его использовании оператор арр1у 
не требуется. 

Файл зе п85.зта@е рекомендуется, но не требуется. Он обрабатывается на 
этапе инициализации, когда бтае определяет, какие файлы сборки в проек- 
те необходимо проанализировать, В случае сборки сразу нескольких проектов 
файл настроек показывает, какие подкаталоги в корневом каталоге также яв- 
ляются каталогами проектов. Ста@е позволяет использовать общие настройки 
и зависимости для подпроектов, сделать один подпроект зависимым от дру- 
гого и даже выполнять сборку подпроектов параллельно. За дополнительной 
информацией о сборках с несколькими проектами обращайтесь к руководству 
пользователя Ста е (В(Ерз://огей Ду/амС] М). 

Исходный код на Кот можно смешивать с исходным кодом на ]ауа в одной 
папке или хранить их отдельно, в разных папках, например $7с/тат//ауа и $гс/ 
тат/КоНт. 


Проекты для Апаго!а 


Плагин поддержки Кош для Апаго! работает немного иначе. Проек- 
ты для Апаго!4 - это сборки Стае с несколькими подпроектами, поэтому 
они обычно имеют два файла БиПа.етаа!е: один в корневом каталоге и один 
в подкаталоге с именем по умолчанию арр. В примере 1.10 показан типич- 
ный файл БиПа.зтае верхнего уровня, содержащий только информацию 
о плагине Кот. 


х. 
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Пример 1.10. Использование Ко{Ип в проектах для Апаго!а (бгооуу ВЕ) 


Би 95сгАрЕ { 
ехЕ.Ко А п_мегз\1оп = '1.3.50' 
геро$\Фог\ез { 


90091е() 
Эсепег() 


} 
Черепдепс\е$ { 
СТаззраВ 'сом.ап@го\19.{0015.Би119:9гае:3.5.0' 
сТаззраеВ «огд. )еБгаллп$ . Ко Ал: Ко 1 п-дгае-р\ид\п: $Ко А п_мег$1оп» 


} 


// ... другие задачи, не связанные с плагином ... 


Затем, выражаясь языком бтае, плагин применяется, как показано в при- 
мере 1.11 стипичным файлом Рина. етаа!е в каталоге арр. 


Пример 1.11. Применение плагина Кот 


арр1у р1ид1п: ‘сом.апдго\9.арр А са Топ? 
арр1у р1ид1п: ‘Ко п-апдго\1а” 0 
арр1у р1ид1п: 'Ко1п-апдго\9-ехфеп$\1оп$' [2] 


апдго\4 { 
// ... апдго\9 АпРогма оп ... 
} 


Черепдепс\е$ { 
1мр1емепеае оп "огд. ]еБга\п$ Ко Ап: Кое Ап - 59 Ь- 9К8 : $Ко А п_мегзлоп" @ 


[/ ... оВег ипге\а%ед дерепдепс\е$ ... 


Ф Применяет плагин Кот для Апаго!а 
@ Применяет расширения для плагина Кот для Апаго!а 


© Определение зависимости от стандартной библиотеки, можно использо- 
вать ШОК 8 или ОК7 


Плагин Ко т для Апаго! объявляется в разделе Би\195сгАр{ и затем применя- 
ется в этом файле. Плагин умеет компилировать код на Кот внутри Апаго!а- 
приложения. В состав загружаемого плагина также входит пакет распгирений для 
Апаго1а, которые упрощают доступ к виджетам Апаго!а по их идентификаторам. 

Плагин поддержки Ко 1 может генерировать байт-код для ШК 7 или ОК 8. 
Измените значение }4К в указанной зависимости, чтобы выбрать предпочита- 
емую версию. 


На момент написания этой книги“нельзя было выбрать Кот ОЗГ 
при создании проекта для Апаго!4. Конечно, можно создать фай- 
лы сборки вручную и использовать в них Кот ОЗГ, но этот подход 
редко применяется на практике. Кот О$Т, будет доступен в версии 
Апаго!а 5910 4.0, которая также будет включать полную поддержку 
файлов КТЗ$ и «живых шаблонов» Ко п. 
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Смотри также 


Тот же процесс с использованием Кот О5Г, кроме’раздела для Апаго1а, по- 
казан в рецепте 1.8. 


1.8. ДоБАВЛЕНИЕ В СВАРЕЕ ПЛАГИНА ПОДДЕРЖКИ Котим 
(синтаксис Котим) 


Задача 


Добавить в систему сборки Сгае плагин поддержки Кот, используя синтак- 
сис КоНт О5Г. 


Решение 
Добавить в файл сборки зависимость Ко т и плагин, используя теги Кот О5Г. 


Обсуждение 


В этом рецепте применяется язык Кот ОЗТ, для Ста е. В предыду- 
щем рецепте показано, как использовать Сгооуу О$Г. для Стае. 


Версия Сгае 5.0 и выше включает новый язык Кот О$Т, для настройки 
файлов сборки. В них также доступен плагин Ко Ап-дгае-р\и9\п, зарегистри- 
рованный в репозитории плагинов Стае, который можно добавить в сце- 
нарий сборки Стае, как показано в примере 1.12. В качестве альтернативы 
можно использовать старый синтаксис Би 19$сг\р+ (см. пример 1.13). Этот код 
нужно добавить в файл БиПа.зта4е.кК15 в корне проекта. 


Пример 1-12. Добавление плагина поддержки Ко{Ип с помощью блока р\дт$ (Кот 051) 


р\идлл$ { 
Ко А п(«)ут») мег$\1оп «1.3.50» 


} 


Пример 1.13. Старый синтаксис добавления плагина поддержки Кот (Ко{Ип 0$1) 


Би 95сгаре { 
героз\ог\е$ { 
пауепСеп{га\() 
} 


Черепдепс\е$ { 
сТазра{В (Ко 1 п(«дгае-р1ид1п», мег$\1оп = «1.3.50»)) 
} 
} 


р\идлл$ { 
Кот (“мт”) 
} 
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Блок р\и9\п5, в отличие отблока героз\ог\1ез, не требует указывать местопо- 
ложение плагина. Это верно для любого плагина Ста е, зарегистрированного 
в репозитории плагинов Сгае. Блок р\и9\п5 также автоматически «применя- 
ет» плагин, поэтому при его использовании оператор арр\у не требуется. 


По умолчанию файлам сборки на Кот О5Т, в Сга@е даются имена 
5е т. та е.К1$ и БиПА.зтае. КЕ. 


Как можно заметить, самые большие отличия от Сгооуу О$Т, заключаются 
в следующем: 

О все строки должны заключаться в двойные кавычки; 

О вКо т Б5Т, необходимо использовать круглые скобки; 

О присваивание в Кош определяется знаком равенства (=), а не двоето- 

чием (:). 

Файл зе! пез. вта!е.К15 рекомендуется, но не требуется. Он обрабатывает- 
ся на этапе инициализации, когда Ста@е определяет, какие файлы сборки 
в проекте необходимо проанализировать. В случае сборки сразу нескольких 
проектов файл настроек показывает, какие подкаталоги в корневом каталоге 
также являются каталогами проектов. СгаМе позволяет использовать общие 
настройки и зависимости для подпроектов, сделать один подпроект зависи- 
мым от другого и даже выполнять сборку подпроектов параллельно. За допол- 
нительной информацией о сборках с несколькими проектами обращайтесь 
к руководству пользователя Стае (В рз://огей Лу/ХС4ЕМ). 

Исходный код на Кот можно смешивать с исходным кодом на ]ауа в папках 
5гс/тат/ауа и ;тс/тат/КоНт, или можно добавить свои собственные исходные 
файлы, используя свойство зоигсе5е{$ в Ста е. За подробностями обращайтесь 
к документации Ста е (6 рз://огей Лу/ХСАЕМ). 


Смотри также 


Тот же процесс с применением Стооуу ОЗТ, показан в рецепте 1.7. Там же вы 
найдете дополнительные сведения о проектах для Апаго!4, где в настоящее 
время Кот ОЗТ, недоступен для выбора при создании проектов Апаго1а. 


1.9. СБОРКА ПРОЕКТОВ НА Котим с помощью СвАОЕЕ 


Задача 
Собрать проект с кодом на Кот, используя Стае. 


Решение 


Добавить зависимость от Кош ОК на этапе компиляции, помимо плагина 
Кот. 
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Обсуждение 
Примеры в рецептах 1.7 и 1.8 показывают, как добавить плагин поддержки 
Ко 1 для Сгае. Этот рецепт демонстрирует добавление новых возможностей 
в файл сборки для обработки любого кода на Кот в проекте. 

Чтобы скомпилировать код Кот с помощью Стае, нужно добавить еще 
один элемент в блок 4ерепдепсте$, как показано в примере 1.14. 


Пример 1.14. Файл БиПа.дгае.К{$ на Кот 0$ для простого проекта 


р\идлл$ { 
`Зауа-АБгагу` © 
Ко Ап(" ум") мег$Лоп "1.3.50" @ 
} 


геро$\Фог4е$ { 
Эсепег() 


} 


Дерепдепс\е$ { 
1пр\етепеа Топ (Кое 4п("5Е9Щ5")) ® 
} 


© Добавляет задачи из плагина ]ауа МЬгагу 
@ Добавляет плагин Кот в Сгае 
© Добавляет стандартную библиотеку Ко т в проект 


Плагин )ауа-1\Ьгагу определяет задачи для простых проектов ] УМ, такие как 
Би19, сотр е3ауа, сотр 1еТез2ама, )а\мадос, }аг и другие. 


Раздел р\и9\пз должен следовать первым, но остальные блоки верхне- 
го уровня (героз\ог1е$, дерепдепсте$ и т. д.) могут располагаться в лю- 
бом порядке. 


Блок Черепдепс1ез добавляет стандартную библиотеку Кот на этапе ком- 
пиляции (чтобы добиться того же эффекта в старой версии Стае, можно ис- 
пользовать конфигурацию сотр Де вместо 1пр{емепта Топ). Блок героз\{ог4е$ ука- 
зывает, что зависимость Кот будет загружена из }сеп{ег - общедоступного 
репозитория АЦНасогу Вштау. 

Если теперь выполнить команду дгае Би119 --9гу-гип, она перечислит за- 
дачи, доступные для выполнения; но не выполнит их: 


> дгае Би -п 


: сотр Деко Ап $КТРРЕБ 

: сопр\Де3ама 5КТРРЕО 

: ргосе$$Кезоигсе$ $КТРРЕ 

:СТаззез ЭКТРРЕБ 
:АпоресЕС1азе$РогКоАпТС 5КТРРЕБ 
:]аг 5КТРРЕБ 

:а°зетб1е 5КТРРЕО 

: сопрДеТезЕКо{1Ап $КТРРЕВ 

: сопрДеТезЕЗауа $КТРРЕР 
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: ргосезТез{Везоигсез$ $КТРРЕВ 
:СезЕСТаззез 5КТРРЕО 

:{ез{ 5КТРРЕВ 

: Сеск 5КТРРЕВ 

:БиД9 5КТРРЕВ 


ВИТЕХ $ИССЕЗ$РИЕ Ап 05 


Плагин Кот добавляет задачи сомреКо Ап, 1пзрес{СТазе5РогКо АлптС и соп- 
реТе{Ко{ п. 

Собрать проект можно той же командой, опустив параметр -п, который яв- 
ляется синонимом параметра --9гу-гип. 


1.10. ИспользовАнИЕ МАМЕМ С Котим 


Задача 
Скомпилировать код на Кот с помощью инструмента сборки Мауеп. 


Решение 


Использовать плагин поддержки Кот для Мауеп и добавить стандартную 
библиотеку в зависимости. 


Обсуждение 


Основные сведения о Мауеп можно найти на веб-странице с документацией 
(6Еёрз://оте| [у/ЬГуЗЬ). 

В документации рекомендуется сначала указать версию Кош в Мауеп- 
файле рот.хтЬ, как показано ниже: 
<ргорег{1е$> 


<Ко{1Ап.\уег$10п>1.3.50</Ко Ап. мег$1оп> 
<[ргорег4е$> 


Затем добавить в зависимости стандартную библиотеку Ко 11, как показано 
в примере 1.15. 


Пример 1.15. Добавление стандартной библиотеки Ко{Ип в зависимости 


<дерепдепс\1е$> 
<дерепдепсу> 
<9гоирТ9>огд. }е{Бга1п$ .КоАп</дгоурТ9> 
<аг\Рас19>Ко{ 1 п-$Е941л16</агЕ\РасТ9> 
<уег$1оп>5{Ко11п.мег$1оп}</мег$\оп> 
</дерепдепсу> 
</дерепдепс\1е$> 


Так же как в Сга4е, можно указать Ко Ап-$&4А\4АЬ-)9кК7 или Ко Ап- 
$9\АЬ-)9к8, чтобы использовать функции расширения для ]ауа 1.7 
или 1.8 соответственно. 


Кроме того, можно использовать артефакты Ко*\Ап-геес{ (поддержка реф- 
лексии) и Ко 1п-{е${ с Ко 1п-{е${-]ип1* (поддержка тестирования). 
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Чтобы скомпилировать исходный код на Кош, нужно сообщить Мауеп, 
в каких каталогах он находится, как показано в примере 1.16. 


Пример 1.16. Определение каталогов с исходным кодом на Кот 


<Би114> 
<5оигсе0\гескогу>${ргоес*.Базед\г} /згс/та\п/Ко 1 п</зоигсе0\гесогу> 
<(е5{боигсе0\гескогу>${рго]ес*.Базед\г} /згс /ез{/Ко{11п</{езЕбоигсе)\гесфогу> 
<[5и114> 


И использовать плагин Кот для компиляции и тестирования (пример 1.17). 


Пример 1.17. Использование плагина Ко{Ип 


<Би114> 
<р\и91п$> 
<р\и91п> 
<аг{\ФРасЕТ9>Ко А п-мауеп-р1и91п</аг{РасЕ14> 
<дгоурТ9>ог9д. }еБга\лп$ .Ко{1Ап</дгоурТ9> 
<уег$1оп>${Ко 11 п.мег$\1оп}</мег$\оп> 


<ехеси{10п$> 
<ехеси 1оп> 
<19>сопрДе</14> 
<90а1$><д90а1>сопр\е</д0а1></д0а1$> 
<[ехеси\оп> 


<ехеси 1оп> 
<19>4е${-сопре</14> 
<90а1$><д90а1>{е5{-сомре</д0а1></90а1$> 

</[ехесиАоп> 

</ехеси{1оп$> 
</р\и91п> 
</р1и91п$> 
<[Ъи114> 


Если проект содержит исходный код на Кот и на ]ауа, первым должен 
компилироваться код на Ко. То есть плагин Ко А п-памеп-р\идАп должен за- 
пускаться перед пауеп-сомрДег-р\и91т. В упоминавшейся выше документации 
показано, как это организовать с помощью параметров конфигурации в файле 
рот.хт/. 


Глава 


Основы Кот 


Эта глава содержит рецепты использования основных возможностей Кот. 
Они демонстрируют приемы программирования без использования специа- 
лизированных библиотек. 


2.1. Использовднигтипов С ПОДДЕРЖКОЙ ЗНАЧЕНИЯ МИЦ. 


Задача 
Гарантировать, что переменная никогда не получит значение пу. 


Решение 


Определить переменную с типом без вопросительного знака в имени. Типы 
с поддержкой значения п также могут использоваться с оператором 
безопасного вызова (?.) и с оператором «Элвис» (?:). 


Обсуждение 


Наиболее привлекательной, пожалуй, особенностью Кот является почти пол- 
ное устранение значения пи\\1. Если в Кош определить переменную с типом 
без знака вопроса в конце, как показано в примере 2.1, то компилятор потре- 
бует, чтобы она никогда не смогла принять значение п 1. 


Пример 2.1. Объявление переменной, не поддерживающей значение пиЦ 
уаг паме: 5+г1пд 
//... позднее ... 


пате = «боу» ® 
[| пате = по 1 @ 


Ф Присваивание непустой строки 
@ Попытка присвоить пи 1 вызовет ошибку компиляции 


Объявление переменной папе с типом 5*г4лпд означает, что ей нельзя присво- 
ить значение пи, иначе код не будет компилироваться. 

Если желательно, чтобы неременная могла получать значение пи, добавь- 
те в объявление вопросительный знак после имени типа, как показано в при- 
мере 2.2. 
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Пример 2.2. Объявление переменной, поддерживающей значение пиЦ 


СТа$$ Регзоп(ма\ Р1г5%: 54гАпд, 
уа1 п19Фе: 5%г4пд?, 
уа\ 1а5{: 54г4пд) 


уа\ )КВомА пд = Регзоп(“Эоаппе”, пи, “ВомАтпд”) ® 
уа1 погЕНИе$Е = Регзоп(“МогЕН”, пи Л, “Ме${”) [2 


© Джоан Роулинг (К ВомЛй1®) не имеет второго имени; она выбрала букву 
К в качестве инициала в честь своей бабушки Кэтрин (Каегте) 


@ Удетей Ким (Кит) и Канье (Капуе) будут проблемы посерьезнее 


В этом классе Рег$оп все равно придется указать значение для второго пара- 
метра, даже если оно пустое. 

Жизнь становится интереснее, когда переменные с поддержкой пи 1 на- 
чинают использоваться в выражениях. Кот требует проверять неравенство 
переменной значению пи \, но это не так просто, как кажется. Например, рас- 
смотрим одну такую проверку (пример 2.3). 


Пример 2.3. Проверка на неравенство уа(-переменной значению пиЦ 
уа1 р = Регзоп(14Аг5& = “МогЕН”, мае = пу\, Таз = “Ме${”) 


АЕ (р.п\9Фе != пу) { 
уа\ п\9д\еМамегепаЕН = р.м\941е. Депо ® 
} 


© Интеллектуальное приведение ктипу 5{г\пд, не поддерживающему зна- 
чение пи 1. 


Оператор 1+ проверит неравенство свойства м194е значению пи Ц, и если это 
так, то Кот выполнит интеллектуальное приведение типа: он будет обраба- 
тывать свойство р.п 9Фе, как если бы-оно имело тип 5+г\пд, а не 54г\пд?. Этот 
прием работает, но только потому, чтолтеременная р была объявлена с ключе- 
вым словом \а1 и не может измениться ‘после инициализации. Если перемен- 
ную объявить как уаг, то код должен выглядеть, как показано в примере 2.4. 


Пример 2.4. Проверка на неравенство значению пиЦ уаг-переменной 


уаг р = Регзоп(14Аг5& = “МогЕН”, мае = пу\, Таз = “Ме${”) 


АЕ (р.п\9Фе != пи) { 
// ма\ мааФ\ематегепаЕН = р.п\94\е. Депо ® 
уа1. п194\еМате епаЕН = р.мА9Фе!!.1епакн @ 


© Интеллектуальное приведение к типу Зите невозможно, потому что 
р.пииае - сложное выражение 


@ Проверка на неравенство пи\1 (не делайте этого без крайней необходи- 
мости) 


Поскольку теперь р объявлена как уаг, а не уа1, Кот предположит, что она 
может измениться между моментом ее определения и моментом обращения 
к свойству м9Ще, и откажется выполнить интеллектуальное приведение типа. 
Одно из возможных решений - использовать оператор проверки (!!), что счи- 
тается дурным тоном. Оператор !! заставляет компилятор интерпретировать 
переменную как имеющую значение, отличное от п Д, и генерировать исклю- 
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чение, если это не так. Это один из немногих способов получить исключение 
№ Ро\пеегЕхсер оп в коде на Кот, поэтому старайтесь его избегать. 

Более удачное решение - использовать оператор безопасного вызова (?.). 
Этот оператор возвращает пи, если значение слева от него равно пи, как по- 
казано в примере 2.5. 


Пример 2.5. Использование оператора безопасного вызова 


уаг р = Регзоп(11г5Е = “МогЕВ”, мае = пу, Таз = “Ме${”) 
уа1 м19Ф\еМатеепаЕН = р.м\9Фе?.1епден ® 


© Безопасный вызов; возвращает значение типа Тп*? 


Проблема втом, что этотоператор возвращает тип, который также допуска- 
етзначение пи 1, поэтому "А 4аТеМате епд А получиттип ТпЁ?, что, скорее всего, не то, 
что вам нужно. Поэтому иногда полезно комбинировать оператор безопас- 
ного вызова с оператором «Элвис» (?:), как показано в примере 2.6. 


Пример 2.6. Комбинирование оператора безопасного вызова с оператором «Элвис» 


уаг р = Регзоп(11г5Е = “МогЕВ”, мае = пу, Таз = “Ме${”) 
уа\ п19Ф\ематегепаЕН = р.п199\е?.1епдЕВ ?: 0 ® 


© Оператор «Элвис» вернет 6, если мА9\е будет иметь значение пл 1 


Оператор «Элвис» проверит значение выражения слева и, если оно не равно 
пу, вернет его. Иначе он вернет значение выражения справа. В данном случае 
он проверит значение выражения р.т194е? .1епдЕН, которое может вернуть це- 
лое число или пи 1. Если выражение вернет целое число, то оператор «Элвис» 
вернет его, иначе - значение выражения 0. 


Справа от оператора «Элвис» может находиться выражение, что 
позволяет использовать геёигп или &Вгои при проверке аргументов 
функции. 


Самая большая сложность - разглядеть в операторе ?: Элвиса Пресли, на- 
клонив голову влево. Очевидно, что Ко создавался для разработчиков с б0- 
гатым воображением4. 

Наконец, в Кот имеется оператор аз? безопасного приведения типа. Он до- 
бавлен с целью избежать исключения С1а5$Саз+Ехсер оп, если приведение типа 
невозможно. В примере 2.7 показано, как безопасно привести экземпляр Рег5оп 
к этому типу, если он может хранить пустую ссылку пи. 


Пример 2.7. Оператор безопасного приведения типа 
уа1 р1 = р а$? Регзоп ® 


© Переменная р1 получит тип Регзоп? 


Приведение либо выполнится успешно - и в результате получится экземп- 
ляр Рег5оп, либо завершится ошибкой - и р1 получит значение пи. 


“ Это в большей степени относится к Сгооуу. На самом деле оператор «Элвис» был за- 


имствован из Стооху. 
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2.2. ДОБАВЛЕНИЕ ПРИЗНАКА ПОДДЕРЖКИ МИЦ. В ЛАУА 


Задача 


Код на Кот должен взаимодействовать с кодом на ]ауа, и требуется, чтобы он 
поддерживал значения пи\1. 


Решение 


Добавить поддержку аннотаций ]58-305 в код на Кош, используя параметр 
компиляции -Х $г305=5г1сЕ. 


Обсуждение 


Одна из основных особенностей Кот - разделение типов с поддержкой и без 
поддержки значения пи\1. Если объявить переменную с типом 5+г\пд, она 
никогда не сможет иметь значение пи\1, а если объявить ее с типом 5*г4пд?, 
то сможет, как показано в примере 2.8. 


Пример 2.8. Типы с поддержкой и без поддержки пи 


уаг $5: 5&гАпа = “Нео, Иог14!” ® 
уаг {: 54г4п9? = пи [2 


© Не может иметь значение пи, код, присваивающий пи\1 этой перемен- 
ной, просто не скомпилируется 


@ Знак вопроса в имени типа указывает на поддержку значения пи 


Это правило не вызывает трудностей, пока не появляется необходимость 
взаимодействовать с кодом на ]ауа, который не имеет такого разделения ти- 
пов. Однако в ]ауа есть аннотация @М№оппи\1, которая определена в пакете ;ауах. 
аппоаНоп. В настоящее время эта спецификация считается бездействующей, 
но во многих библиотеках есть так называемые аннотации, совместимые 
с]5Е-305, и Кот их поддерживает. 

Например, совместимость с $рипе Егатемогк можно обеспечить, добавив 
в файл сборки Сга@е код из примера 2.9. 


Пример 2.9. Обеспечение совместимости с )5К-3505 в бгае (бгооуу 051) 


оигсеСотралЬ Ду = 1.8 
сотр ДеКо Ал { 
Ко АпОроп$ { 
ЭумТагде* = «1.8» 
{гееСотр^ДегАга$ = [«-Х)$г305=5 гс» ] 
} 


} 
сотр ДеТе${Ко{ Ап { 
Ко А пОрЕТоп$ { 
ЭумТагде* = «1.8» 
{гееСотр^ДегАга$ = [«-Х)$г305=5 гс» ] 


То же самое можно выразить на Кот О5Т, как показано в примере 2.10. 


х. 
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Пример 2.10. Обеспечение совместимости с /5К-305 в бга@е (Ко{Ип $1) 


фа$К$ .иАЕВТуре<Ко 1пСотрДе> { 
Ко 1 пОроп$ { 
ЭумТагде{ = «1.8» 
ТгееСотр\ДегАгд$ = 115401 (“-Х)$г305=$4 гс”) 


Использующие Мауеп могут добавить фрагмент из примера 2.11 вфайлРОМ, 
как рекомендовано в справочном руководстве по Кот. 


Пример 2.11. Обеспечение совместимости с /5К-3505в-Мауеп 


<р\и91п> 
<дгоурТ4>огд. )еБгаллп$ .Ко{ 11 п</дгоурТ9> 
<аг\Рас&Т9>Ко А п-тамуеп-р1и91п</аг\Рас&Т9> 
<уег$1оп>${Ко 11 п .мег$\1оп}</мег$\оп> 
<ехеси1оп$>...</ехеси1оп$> 
<сопЕАдигаоп> 
<помагп>&гие< /помагп> <!-- Отключить предупреждения --> 
<аг9$> 
<!-- Включить строгий режим для аннотаций 258-305 --> 
<аг9>-Х)$г305=5г4с{</аг9> 


</аг9$> 
</сопАдига 1 юоп> 
</р\и91п> 


Аннотация @№ппи\1, которая определена в ]5В-305, имеет свойство ипеп. 
Если ему присвоить значение Мпеп.А!АУ$, аннотированный тип будет обраба- 
тываться как не поддерживающий значение пи 1. Если присвоить Меп.МАУВЕ 
или ИПеп.МЕ\ЕВ, то будет считаться, что тип поддерживает значение п\1. Если 
присвоить Ипеп.ИМКМОММ, то будет предполагаться, что тип является платфор- 
менным типом, для которого допустимость значения пи\1 неизвестна. 


2.3. ДОБАВЛЕНИЕ ПЕРЕГРУЖЕННЫХ МЕТОДОВ ДЛЯ ВЫЗОВА 
из ЛАМА 


Задача 


Имеется функция на Ко ш/с‘параметрами по умолчанию. Обеспечить возмож- 
ность ее вызова из ]а\уа без необходимости явно указывать значения для всех 
параметров. 


Решение 
Добавить к функции аннотацию @2ут0уег\оа4$. 


Обсуждение 


Пусть имеется функция на Ко т, которая определяет значения по умолчанию 
для одного или нескольких параметров, как показано в примере 2.12. 
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Пример 2.12. Функция на Кот с параметрами по умолчанию 


Рип адЧРгодисе(пате: 5%г4пд, рглсе: Боч Ще. = 0.0, дезс: 54г4пд? = пи1\) = 
“АЧФАпд ргодисЕ мАЕП Фпате, ${9езс ?: “Мопе” }, апд “ + 
МитрегРогта* . деЕСиггепсуТп${апсе() .Гогма{(рг\1се) 


Функция адаРгодис* требует обязательно передавать ей строковое имя (папе), 
но описание (дес) и цена (рг4се) имеют значения по умолчанию. Описание до- 
пускает значение п 1 и по умолчанию равно пи, а цена по умолчанию равна 0. 

Как показывает тест в примере 2.13, эту функцию легко можно вызвать из 
Кот с одним, двумя или тремя аргументами. 


Пример 2.15. Вызов функции с параметрами по умолчанию из Кот 


@Тез+ 
Рип `сВеск а оуег1оад$`() { 
аззегАД (“Оуег\оа4$ саДеф Ргот Ко Ап”, 
{ реп п(а99Ргодисе(“Мате”, 5.0, “Оезс”)) }, 
{ реп лп(а99РгодисЕ(“Мате”, 5.0)) }, 
{ ргАпЕп(ад99Ргодис(“Маме”)) } 


Каждый последующий вызов ад9Ргодис+ передает на один аргумент меньше, 
чем предыдущий. 


Необязательные свойства или свойства с поддержкой значения пи\1 
следует размещать в конце сигнатуры функции, чтобы их можно было 
не учитывать при вызове функции с позиционными аргументами. 


Все вызовы выполняются успешно. 

Однако ]ауа не поддерживает параметры по умолчанию, поэтому, чтобы 
вызвать эту функцию из ]ауа, придется передать все аргументы, как показано 
в примере 2.14. 


Пример 2.14. Вызов функции из ]ауа 


@Тез+ 
\014 зирр\УАСАгдаитепт$() { 

Зуз{ем. оц{ . рглпп(Оуег1оа9$К®. ад4РгодисЕ (“Мате”, 5.0, “Оезс”)); 
} 


Если перед функцией добавить аннотацию @)\т0уег1оа4$, сгенерированный 
класс будет включать все необходимые перегруженные версии функции, как 
показано в примере 2.15. 


Пример 2.15. Вызов всех перегруженных версий функции из }ауа 


@Тез+ 
у014 спескО\ег1оад$() { 
аззегЕАЦ (“оуег\оа4$ саДеф Ргом Эаума”, 
() -> буфет. оц . рп п(О\ег1оад$К*. адЧРгодис* (“Мате”, 5.0, “Оезс”)), 
() -> бузет. оц. рглпЕп(Оуег1оад$КЕ. а4Ргодис*(“Маме”, 5.0)), 
() -> буфет. оц . рп п(О\ег1оа9$КЕ. ад 4Ргодис* (“Мате”)) 


); 


х. 
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Чтобы понять, как это работает, можно декомпилировать байт-код, сгенери- 
рованный компилятором Кот. В примере 2.16 показан код, сгенерированный 
без аннотации @)\ут0уег\оад$. 


Пример 2.16. Декомпилированный байт-код функции, сгенерированный компилятором 
Кот 


@Моемит 

рус зас РАпай 54г1пд ад9РгодисЕ(@М№ {Ми 54г4пд папе, 
дочБ\е рг4се, @МиЛаБЛе $%глла езе) { 
Тпёг\п$1с$ . спескРагаме*егТ$№{Ми\\(паме, “пате”); 


Ая 


А впримере 2.17 показан код, сгенерированный с аннотацией @3\ут0уег1оад$. 


Пример 2.17. Декомпилированный байт-код функции с перегруженными версиями 


[/ руБЛАс ЁАпа\ с1аз$ Омег1оа9$К* { 

@)утО\ег\оа4$ 

@Моемит 

рус ас РАпа\ $4г1пд ад9Ргодисе (@М№\*М 11. $54гАпд папе, 
дочБЛе рг4се, @МиЛаБЛе 5%г4пд дес) { 
Тпёг1п$1с$ . спескРагаме*егТ$М№{Ми\\(паме, “пате”); 


Ао 
3 


@)утО\ег1оа4$ 
@МоемМи 
рус зас РАпа\ 5{г4пд аЧ99Ргодис( 
@Мо{ М1. $%г1п9 паме, дочБЛе рглсе) { 
гефигп а99Ргодис&$еРац\*(пате, рг\се, 
(ЗЕглп9) пи, 4, (ОБ)есе)пи\.); 
} 


@)утОуег1оа4$ 
@МоМит 
рус ас РАпа\ ${г1пд ад9РгодисЕ (@М {Мл 5%гАпд пате) { 
гефигп ад9Ргодис&$деРац\(пате, 0.00, 
(ЗЕг1п9) п, 6, (ОБ)есе)пи\.); 


Сгенерированный класс включает дополнительные методы, которые вызыва- 
ют полную версию метода и передают аргументы со значениями по умолчанию. 

Аналогичный прием можно применять к конструкторам. Класс Ргодис{ в при- 
мере 2.18 генерирует три конструктора: один принимает все три аргумента, 
один - только имя и цену, и еще один - только имя. 


Пример 2.18. Класс на Кот с перегруженными конструкторами 


Чака с1а$$ Ргодисе @)\тОуег\оа4$ соп$гисфог( 
уа1 паме: 5%г\пд, 
уа\ рг4се: БоуБЛе 
уа\ дезс: 54г4пд? 


0.0, 
пи. 
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Чтобы добавить аннотацию @)\ут0уег1.оад$, необходимо явно вызвать соп$гис- 
фог. Теперь создать экземпляр класса можно тремя разными способами, как 
показано в примере 2.19. 


Пример 2.19. Создание экземпляра класса РгодисЕ из Кот 


@Тез+ 
1пеегпа\ Фип `сНескК оуег1оадед Ргодис& сопёгисфог`() { 
аззегАЩ (“Оуег\оа4$ саДеф Ргот Ко Ап”, 
{ реп лп(РгодисЕ(“Мате”, 5.0, “Оезс”)) }, 
{ реп п (РгодисЕ(“Мате”, 5.0)) }, 
{ реп п(РгодисЕ(“Мате”)) } 


Все эти конструкторы также можно вызвать из Тауа, как показано в примере 2.20. 


Пример 2.20. Создание экземпляра класса РгодисеЕ из ]ауа 


@Тез+ 
у014 спескО\ег\оадедРгодисСког() { 
аззег(АЦ (“оуегоа4$ саДеф Ргом Эама”, 
() -> буз{ет. ое. рп п(пем Ргодис*(“Маме”, 5.0 
() -> буз{ет. ое. ргАпп(пем РгодисЕ(“Маме”, 5.0 
() -> буз{ет. оц. рглпп(пем Ргодисе(“Маме”)) 


‚ “0езс”)), 
)), 
); 


Этот прием работает, но имеет одну интересную тонкость. Если взглянуть 
на декомпилированный код класса Ргодис*, можно увидеть все необходимые 
конструкторы (пример 2.21). 


Пример 2.21. Перегруженные конструкторы РгодисЕ в декомпилированном коде 


@)утОуег1оа4$ 

рус Ргодисе(@Мо Ми. 5%г1пд паме, доче рглсе, 
@МПаБДе 5%г1пд дес) { 
Тпёг1п$1с$ . спескРагамефегТ$М№{Ми1\(паме, “пате”); 
зирег(); 
В1$.пате = паме; 
ВА $.рг1се = рг\се; 
В1$.4е$с = дес; 


) 


@)утОуег1оа9$ 
рус Ргодисе(5гАпд уаг1, ФоибЛе уаг2, 5%г1пд \аг4, 
1ПЕ \уаг5, беРац\Соп${гисфогМагКег уагб)={ 


ИИ ве 

+11$(\аг1, уаг?, уаг4); ® 
} 
@)утОуег1оа4$ 


рус РгодисЕ(@Мо Ми. $4г1пд паме, доче рглсе) { 
+11 $(паме, рг4се, (5%гАпд)пи 11, 4, (БеРаи\Соп$ЕгисфогМагКег)пи\1.); @ 
} 
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@)утОуег\1оа9$ 
рус РгодисЕ(@Мо Ми. 5%г1пд паме) { 

+11 $(паме, 0.00, ($4г4пд)пи 11, 6, (БеРаи\{Соп$ЕгисфогМагКег)пи\1); ®@ 
} 


© Вызов конструктора с тремя аргументами 


9 Вызов сгенерированного конструктора, который, в свою очередь, вызы- 
вает конструктор с тремя аргументами 


Все перегруженные конструкторы в конечном итоге вызывают полную вер- 
сию стремя аргументами, подставляя значения по умолчанию. Это нормально, 
но имейте в виду, что вызов конструктора с необязательными аргументами 
не вызывает аналогичный конструктор в суперклассе; все вызовы следуют че- 
рез один конструктор с наибольшим количеством аргументов. 


Вызов конструкторов с аннотацией @2\ут0уег1оа4$ не приводит квы- 
зову зчрег с тем/же количеством аргументов. В действительности 
вызывается полный конструктор с подставленными значениями 
по умолчанию. 


В ]ауа каждый конструктор вызывает конструктор родительского класса 
с помощью зчрег, и в перегруженных конструкторах часто вызывается зирег 
с тем же количеством аргументов. В данном случае этого не происходит: вы- 
зывается конструктор суперкласса со всеми параметрами и подставленными 
значениями по умолчанию. 


2.4. ЯвноЕ ПРЕОБРАЗОВАНИЕ ТИПОВ 


Задача 


Кол не преобразует автоматически простые типы в более широкие перемен- 
ные, например Тп+ в [опд. 


Решение 


Использовать функции явного преобразования типов, такие как фоТп\, +01опд 
ИТ. д. 


Обсуждение 

Один из сюрпризов, который Кот преподносит разработчикам на ]ауа, - ко- 
роткие типы не преобразуются автоматически в более длинные. Например, 
в Гауа совершенно нормально писать код, как показано в примере 2.22. 
Пример 2.22. Автоматическое преобразование коротких типов в более длинные в /ауа 


1пе муТпЕ = 3; 
1опд муЁопд = муГпё; ® 


© Тип ие автоматически преобразуется в 10пд 


Появившаяся в ]ауа 1.5 автоматическая упаковка облегчила преобразование 
простых типов в типы-обертки, но преобразование из одного типа-обертки 
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в другой по-прежнему требует дополнительногокода, как показано в приме- 
ре 2.23. 


Пример 2.25. Преобразование типа тедег в тип №0пд 
Тп{едег пуТптедег = 3; 

// Еопд тумгарредЁопда = пуТп%едег; 0 

[опа муМгарреопд = муТпхедег. 1опа\а\ие(); @ 
му\гарредЕопд = [опд.\а\ие0{(птуТпедег); [3] 


© Не компилируется 
@ Извлекает значение типа Т1опд и затем обертывает его 


© Распаковывает значение типа \1п*, преобразует в тип 1опд и затем обер- 
тывает его 


Иначе говоря, работа с типами-обертками напрямую требует выполнять 
распаковку вручную. Нельзя просто присвоить экземпляр типа Тт(едег пере- 
менной типа [опд, не распаковав обернутое значение. 

В Кош простые типы не поддерживаются напрямую. Байт-код может гене- 
рировать их эквиваленты, но, работая над своим кодом, вы должны помнить, 
что имеете дело с классами, а не с примитивами. 

К счастью, Кот предлагает методы преобразования, такие как фоТп\, оЁопд 
ит. д., как показано в примере 2.24. 


Пример 2.24. Преобразование типа [п в тип [опд в Кот 


уа\ 1пЕ\аг: Тпё = 3 
// уа1 Топа\аг: 10пд = Ап Маг © 
уа1 Топд\аг: [опа = 1п\аг.{010пд() ® 


© Не компилируется 
@ Явное преобразование типа 


Поскольку в Кот 1п\\аг и 1опд\аг являются экземплярами классов, невоз- 
можность автоматически преобразовать экземпляр Тп+ в тип [опд не выглядит 
удивительной. Но об этом легко забыть, особенно если есть опыт работы с ]ауа. 

Вот некоторые из доступных методов преобразования: 

ТоВуфе: Ву{е; 
фоСВаг: Сваг; 
фоброг*: ЭРог*; 
фоТпЕ(): ТпЕ; 
фо10п9(): 10п9д; 
фоР1оа{(): РЕ1оа{; 
фобочБ1е(): БоиБТе. 


К счастью, Кот позволяет использовать преимущества перегрузки опера- 
торов для прозрачного преобразования типов, поэтому следующий код нетре- 
бует явного преобразования: 


охохожохохохо 


уа\ 1опдбим = ЗЕ + 1п Маг 


Оператор р\из автоматически преобразует значение 1п\\аг в тип 1опд и сло- 
жит его с литералом типа Т1опд. 
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2.5. Вывод ЧИСЕЛ В»РАЗНЫХ СИСТЕМАХ СЧИСЛЕНИЯ 


Задача 
Вывести число в системе счисления, отличной ОТ десятичной. 


Решение 


Использовать функцию-расширение {о54г4пд(гад\х: Тп) с допустимым значе- 
нием гадАх. 


Обсуждение 


Этот рецепт предназначен для особых ситуаций, которые возника- 
ют нечасто. Однако описываемая в нем возможность представляет 
определенный интерес и может пригодиться в программах, исполь- 
зующих разные системы счисления. 


Есть одна старая шутка: 


Люди делятся на 10 типов 
Которые знают двоичное счисление, и которые не знают его 


В ]ауа, чтобы вывести число в двоичной системе счисления, нужно исполь- 
зовать статический метод Тп\едег. фоВАпагу${г4па или Тп%едег.{о5г1па(Апе, 1п®). 
В первом аргументе передается число для вывода, а во втором - основание 
системы счисления. 

Кот взял статический метод из\]ауа и превратил его в функцию-расши- 
рение +054г4пд (гаФх: Тпё) для типов Ве, эвогЕ, Тпе и [опд. Например, в при- 
мере 2.25 показано, как в Кот преобразовать число 42 в строку с двоичным 
представлением. 


Пример 2.25. Вывод числа 42 в двоичном представлении 
42.1054г1п9(2) == “101010” 

В двоичном представлении биты, справа налево, имеют значения 1, 2, 4, 8, 
16 ит. д. Так как 42 - это 2 +8 + 32, то биты в соответствующих позициях имеют 


значение 1, а остальные - значение 0. 
Вот как выглядит реализация метода +о5{г\пд в классе ТпЕ: 


рус асфиа\ 1п1 пе Фип Тпе. в054гАпд(гадАх: Тпе): 5&гАпд = 
Зауа.Тапд.Тпедег.{о5г1па(+ЕВА$, срескВаЧ\х(га\х)) 


То есть функция-расширение в Тпё вызывает соответствующий статиче- 
ский метод класса )ама.1апд.Тп%едег, предварительно проверив второй аргу- 
мент гад\х. 


Ключевое слово ас{ца\ отмечает, что реализация зависит от платформы. 
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Метод сНесквах проверяет, находится ли указанное основание системы счис- 
ления в диапазоне от СВагасфег.МТМ_ВАОТХ до Свагас{фег.МАХ_КАОТХ (в данном случае 
подразумевается реализация для ]ауа), и если это не так, то возбуждает исклю- 
чение Г\1еда\Агдитеп{Ехсер оп. Допустимыми минимальным и максимальным 
значениями являются 2 и 56 соответственно. Пример демонстрирует вывод 
строковых представлений числа 42 во всех допустимых системах счисления. 


Пример 2.26. Вывод строковых представлений числа 42 во всех допустимых системах счис- 
ления 


(СПагасфег.МТМ_ВАОТХ. .Спагасеег.МАХ_ВАОТХ).РогЕасв { гаФАх -> 
ргап п(“5гаАх: ${42.ко5г4п9(гадх)}”) 
} 


Этот пример выведет следующий текст (здесь он немного отформатирован): 


Вад\лх \Ма\ие 


2: 101019 
3: 1120 
4: 222 
5: 132 
6: 110 
т 60 
8: 52 
9: 46 
10: 42 
32: 1а 
33: 19 
34: 18 
35. 17 
36: 16 


Число 42 - это «ответ на главный вопрос жизни, Вселенной и всего 
сущего» (по крайней мере, согласно Дугласу Адамсу в его серии «Ав- 
тостопом по галактике»). 


Объединение этой возможности с поддержкой многострочного текста дает 
Ко т-версию оригинальной шутки (см. пример 2.27). 


Пример 2.27. Усовершенствованная версия шутки о знании-двоичной системы счисления 
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уа1 )оКе = 
Люди делятся на ${3.%05%г4п9(3)} типов 
Которые знают двоичное счисление, и которые не знают его, 


А для тех, кто не заметил, -- это троичная шутка 
“> ЕгАиТпдепе() 
рглп Ел ( д оКе) 


Этот код выведет следующий текст: 


Люди делятся на 10 типов 
Которые знают двоичное счисление, и которые не знают его, 
А для тех, кто не заметил, -- это троичная шутка 


х. 
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2.6. ВОЗВЕДЕНИЕ ЧИСЛА В СТЕПЕНЬ 


Задача 


Возвести число в степень, но обратите внимание, что в Кот нет предопреде- 
ленного оператора возведения в степень. 


Решение 


Определить инфиксную функцию, которая вызывает уже имеющуюся функ- 
цию-расширение ром в классах Тп{ и 10пд. 


Обсуждение 


В Кот, так же как в ]ауа, нет встроенного оператора возведения в степень. 
В /ауа имеется статическая функция ром в классе дауа.1апд.МаЕН со следующей 
сигнатурой: 


рус зас доиБЛе МафВ.рои(доч6БЛе а, доче Ь) 


Поскольку в ]ауа поддерживается автоматическое расширение простых типов 
(например, 4лп{ в доче), достаточно только одной этой функции. В Кот, одна- 
ко, простые типы не поддерживаются непосредственно, а экземпляры классов, 
таких как Тп+, не преобразуются автоматически в экземпляры [!опд или боче. 
Это вызывает особое раздражение, когда вы обнаруживаете, что стандартная 
библиотека Кот определяет функции-расшгирения рои только для Е\1оа{ и Боие. 

Эти функции-расшгирения имеют следующие сигнатуры: 


Рип боуБЛе.ром(х: БочЛе): ВБочЛе 
Рип РЛоа.ром(х: Е\оа{): Р\оа* 


То есть, чтобы возвести в степень целое число, нужно преобразовать его 
в тип Е1оа* или Боуч Де, вызвать ром и затем преобразовать результат обратно 
в целое число, как показано в примере 2.28. 


Пример 2.28. Возведение в степень значения типа |п& 


@Тез+ 
Рип `га1фсе ап Тпё Ко а ромег`() { 

аззег{ТВа{(256, едца\То(2.фобоч6Те().ром(8).фоТп())) 
} 


Для возведения в степень 2 идеально подходят функции $81 и $1г, 
как показано в рецепте 2.7. 


Это вполне работоспособное решение, ноегоможно автоматизировать, опре- 
делив в классах Тпё и 1ю0п9д функции-расширения со следующими сигнатурами: 


Рип Тпё.ром(х: Тпе) = фобоие().ром(х).фоТпЕ() 
Рип [опд.ром(х: Тпе) = фобои1е().рош(х).010п9() 


Но еще лучше определить инфиксный оператор. Для перегрузки можно ис- 
пользовать только ограниченный круг символов операторов, но эту проблему 
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можно преодолеть, заключив оператор в обратные кавычки, как показано в при- 
мере 2.29. 


Пример 2.29. Определение инфиксного оператора возведения в степень 


АтрогЕ Ко{14п.тафН. ром 


АаАх Рип Тпе.`**`(х: Тпе) = кобочЛе().ром(х).коТпе() 
АаРАХ Рип [0п9.`**`(х: Тпё) = обои Ле().ром(х). ЕоЁоп9() 
ЛиАх Рип РЛоа*.`**`(х: Тпе) = ром(х) 

АпАх Рип ОбоиЛе.`**`(х: Тпё) = рои(х) 


[/ Шаблон, напоминающий существующие функции в Е\оа{ и БочЛе 
Рип Тпе.рои(х: Тп®) = `**`(х) 
Тип [опд.ром(х: ТпЕ) = `**`(х) 


В определении ** было использовано ключевое слово 1п Ах, но функции-рас- 
ширения ром для Тп+ и 1опд определены без него, чтобы сохранить шаблон, реа- 
лизованный в Е\оа* и боч Те. 

Теперь символ ** можно использовать в роли оператора возведения в сте- 
пень, как показано в примере 2.50. 


Пример 2.30. Использование функции-расширения ** 


@ТезЕ 
Рип `га1фе $о ромег`() { 
аззег{А ( 
{ аззегЕТВае(1, едиа1То(2 `**` 0)) }, 
{ аззегЕТВае(2, едиа1То(2 `**` 1)) }, 
{ аззегЕТВае(4, едиа1То(2 `**`2)) }, 
{ аззегЕТВа*(8, едиа\То(2 `**` 3)) }, 


{ аззегЕТНае(1Ё, едиа1То(2 `**` 0)) }, 
{ аззегЕТНае(21, едиа1То(21 `**` 1)) }, 
{ аззегЕТНае(4Ё, едиа1То(21 `**`2)) }, 
{ аззегЕТнаЕ(8Е, едиа\То(21 `**` 3)) }, 


{ аззегЕТНае(1Е, едиа1То(2Е `**` 0)) }, 
{ аззегЕТНае(2Е, едиа1То(2Е `**` 1)) }, 
{ аззегЕТНае(4Е, едиа1То(2Е `**`2)) }, 
{ аззегЕТваЕ(8Е, едиа\То(2Е `**` 3)) }, 


‚ 1е-6)) }, 
‚ 1е-6)) }, 
‚ 1е-6)) }, 
‚ 1е-6)) }, 


{ аззегЕТВа*(1.0, с1озеТо(2.0 `**` 
{ аззегЕТВа*(2.0, с1озеТо(2.0 `**` 
{ аззегЕТВа*(4.0, с1озеТо(2.0 `**` 
{ аззегЕТВа*(8.0, с1озеТо(2.0 `**` 


>) 


{ аззегЕТВа*(1, едиа1То(2.ром(0))) }, 
{ аззегЕТВае(2, едиа1То(2.ром(1))) }, 
{ аззегЕТВае(4, едиа1То(2.ром(2))) }, 
{ аззегЕТВа*(8, едиа\То(2.ром(3))) }, 


{ аззегЕТВаЕ(11, едиа1То(2в.ром(0))) }, 
{ аззегЕТвае(21, едиа1То(2[ром(1))) }, 
{ аззегЕТНа*(41, едиа1То2Ё:ром(2))) }, 
{ аззегЕТВа{(8Е, едиа1То(2Е.:рои(3))) } 
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В тестах с боу\е.** используется функция сравнения с1озеТо из библиотеки 
Натсгез, помогающая проверить равенство значений с плавающей точкой. 
В тестах с Р\оа+, вероятно, стоило бы сделать то же самое, но в настоящее время 
тесты успешно выполняются в текущем их виде. 


Идея определения инфиксной функции для этой цели была пред- 
ложена в ответе Оливии Зои (ОП\а 7ое) на вопрос на сайте З{аск 
ОуетгНомх (Брз://огей.1у/1®01У). 


Если вам не нравится заключать оператор «звездочка-звездочка» в об- 
ратные кавычки, попробуйте определить функцию с другим именем, на- 
пример ехр. 


2.7. ОПЕРАТОРЫ ПОРАЗРЯДНОГО СДВИГА 


Задача 
Выполнить операцию поразрядного сдвига. 


Решение 


Для этой цели в Кот имеются поразрядные инфиксные функции, такие как 
$Вг, $1 и иг. 


Обсуждение 


Поразрядные операции имеют широкий круг применения, например для 
управления списками доступа, в протоколах связи, в алгоритмах сжатия 
и шифрования и в компьютерной графике. В отличие от многих других языков, 
Кот не использует предопределенные символы операторов для обозначения 
операций сдвига, а определяет их как функции. 

В Кот определены следующие операции сдвига в виде функций-расшире- 
ний в Тпе И 1010: 


НТ 

сдвиг влево со знаком; 
$Нг 

сдвиг вправо со знаком; 
и$Вг 


сдвиг вправо без знака. 


Согласно правилам арифметики дополнения до двух, поразрядный сдвиг 
влево или вправо подобен умножению или делению на 2, как показано в при- 
мере 2.31. 
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Пример 2.31. Умножение и деление на 2 


@ТезЕ 
Рип `доч6\Апд апд Ва\\лд`() { 
аззег{АЦ. (“ТегЕ $ВАРЕ$ доча Ргом 1”, // 0000_0001 
{ аззегЕТВа*( 2, едиа1То(1 $1 1)) }, // 0000_0010 
{ аззегЕТВа*( 4, едиа1То(1 $1 2)) }, // 0000 0100 
{ аззегЕТра*( 8, едиа1То(1 $1 3)) }, // 0000_1000 
{ аззегЕТрВа*( 16, едиа1То(1 $1 4)) }, // 0001 0000 
{ аззегЕТва*( 32, едиа1То(1 $1 5)) }, // 0010 0000 
{ аззегЕТВа*( 64, едиа1То(1 $1 6)) }, // 0100 0000 
{ аззегЕТВа*(128, едиа1То(1 $В1 7)) } // 1000_0000 
) 


аззег{АЦ (“главе $ПАРЕ$ Ва\\\па Ргом 235”, // 1110 1011 
{ аззегЕТВа*(117, едиа\То(235 $Вг 1)) }, // 0111 0101 
{ аззегЕТВа*( 58, едиа\То(235 $Вг 2)) }, // 0011 1010 
{ аззегЕТнае( 29, едиа\То(235 $Вг 3)) }, // 0001_1101 
{ аззегЕТрае( 14, едиа\То(235 $Вг 4)) }, // 0000_1110 
{ аззегЕТвае( 7, едиа\То(235 $Вг 5)) }, // 0000 0111 
{ аззегЕТвае( 3, едиа\То(235 $Вг 6)) }, // 0000 0011 
{ аззегЕТнае( 1, едиа\То(235 $Вг 7)) } // 0000 0001 


Функция изВг используется в случаях, когда требуется выполнить сдвиг без 
сохранения знака. Для положительных значений з1г и изВг ведут себя одинако- 
во. Но для отрицательных значений з№г дополняет результат единицами слева, 
благодаря чему он остается отрицательным, как показано в примере 2.32. 


Пример 2.32. Использование функций изПг и $Нг 


уа\ п1 = 5 
уа\ п2 = -5 
ргАп п (п1.05г1п9(2)) // 060101 
ргАп п (п2.105г1п9(2)) // -060101 


аззегТВа{(п1 $Рг 1, едиа\То(0950010)) [12 
аззегТВа{(п1 изВг 1, едиа1То(950010)) [12 


аззег(ТВае(п2 $Вг 1, едиа1То( -050011)) // -3 
аззег(ТВае(п2 изг 1, едиа\То(@х7ЕЕЕ_+119)) // 2_147_ 483645 


Кажущееся странным поведение последнего примера обусловлено дей- 
ствием правил арифметики дополнения до двух. Так как чз№г заполняет ре- 
зультат слева нулями, она не сохраняет отрицательный знак -3. Результа- 
том является дополнение до двух 32-битного целого числа -3, как показано 
в комментарии. 

Функция чзВг встречается во многих местах. Один интересный пример воз- 
никает при попытке найти середину двух больших целых чисел, как в приме- 
ре 2.33. 

Функция изВг имеет массу применений. Один из интересных примеров - 
поиск середины между двумя большими целыми значениями, как показано 
в примере ниже. 


х. 
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Пример 2.33. Поиск середины между двумя большими целыми значениями 
уа\ 19п = (0.99 * ТпЕ.МАХ \АЕИЕ).ЕоТпЕ() 
уа\ 1ом = (0.75 * ТпЕ.МАХ МАШЕ). оТпЕ() 


уа1 м191 = (РАЗН + 10м) / 2 © 
уа1 м192 = (РАЗН + 10ом) избг 1 @ 


аззегЕТгие(т191 !4п Том. .Б19В) 
аззег{Тгие(т192 1п 10и..БлаН) 


о Сумма больше максимально возможного значения Тпъ, поэтому резуль- 
тат получится отрицательным 


@ Сдвиг вправо без знака гарантирует, что результат будет находиться в се- 
редине указанного диапазона 


Если оба значения достаточно большие, то их сумма окажется больше, чем 
Тпё.МАХ_\АГОЕ, и в результате получится отрицательное число. Если деление на 
2 выполнить функцией сдвига вправо, то результат будет находиться в середи- 
не указанного диапазона. 

Вычисление среднего значения двух целых чисел, каждое из которых может 
оказаться очень большим, требуется во многих алгоритмах, таких как бинар- 
ный поиск или сортировка. Использование иг в подобных алгоритмах гаран- 
тирует, что результат всегда будет находиться в требуемом диапазоне. 


2.8. ИспользовднигьпоърАЗРЯДНЫХ ОПЕРАТОРОВ 


Задача 
Применить маску к битовым значениям. 


Решение 


Использовать поразрядные операторы ап, ог, хог и 1пу, поддерживаемые 
в Кот. 


Обсуждение 


В дополнение к операторам сдвига, определенным в классах Тп* и [опд, Кот 
поддерживает также операции маскирования: апф, ог, хог И 1пу (не «по{»). 

Последняя функция в этом списке - 4пу - переворачивает все биты в числе. 
Возьмем для примера число 4, которое в двоичном представлении имеет вид 
0690000100. Если перевернуть все биты, получится число 6611111011, которое в де- 
сятичном представлении имеет вид 251. Однако если вызвать функцию \1пу 
с числом 4, то вы получите в результате -5, как показано в примере 2.34. 


Литералы, начинающиеся с префикса еь, выражают значения в дво- 
ичном представлении. 
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Пример 2.34. Инверсия числа 4 


[/ 4 == 050000 0100 (в двоичном представлении) 

// Поразрядное дополнение (смена значений всех битов) дает: 
// 951111 1011 == 251 (в десятичном представлении) 
а$зег{Едца1$(-5, 4.4п\()) 


Для разделения групп разрядов в числовых литералах можно ис- 
пользовать символы подчеркивания (). Компилятор игнорирует их. 


Но почему вместо 251 получается -5? Дело в том, что система выполняет 
арифметические действия с дополнением до двух. Дополнение до двух для лю- 
бого целого числа п задается как -(-п + 1), где -п - это дополнение числа п до 
единицы (то есть смена значений всех битов на противоположные). Следова- 
тельно: 


0511111011 -> -(050000_0100 + 1) -> -060000_0101 -> -5 


Дополнением до двух для числа 251 является число -5. 

Поразрядные операторы апд, ог и хог хорошо знакомы большинству разра- 
ботчиков. Единственная разница между ними и их логическими аналогами 
в том, что они не поддерживают вычисления по короткой схеме. Рассмотрим 
пример 2.35. 


Пример 2.35. Использование операторов апа, ог и хог 


@Тез+ 

Рип `апд, ог, хог`() { 
уа\ п1 = 059000_1100 // десятичное 12 
уа\ п2 = 059001_1001 // десятичное 25 


уа\ п1_ап4_п2 = п1 апд п2 
уа\ п1_ог_п2 = 11 ог п2 
уа1 п1_хог_п2 = п1 хог п2 


аззег{ТВа{(п1_ап9_п2, едиа1То(060000_1000)) // 8 
аззег{ТВа{(п1_ог_п2, едиа1То(060001_1101)) // 29 
аззег{ТВа{(п1_хог_п2, едиа1То(060001—9101)) // 21 


В качестве более интересного]йримера рассмотрим модель ВСВА пред- 
ставления цветов, реализованную в классе )а\а.ам*.Со1ог в ]ауа. Цвет можно 
представить как 4-байтное целое число, где по 1 байту отводится для значения 
красного, зеленого и синего каналов, а также альфа-канала (определяющего 
степень прозрачности). Взгляните на рис. 2.1. 


АЛЬФА КРАСНЫЙ ЗЕЛЕНЫЙ СИНИЙ 
061111 - оБееее | 061111 - обееее | 051111 - обееее | ©61111 - ебееее 


Рис. 2.1. 52-битное целое, в котором для каждого канала отводится по 1 байту 
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В описании метода деВСВ класса Со1ог говорится, что по умолчанию он воз- 
вращает 1п{ со «значением ВСВ в цветовой модели $ВСВ (биты 24-31 - альфа- 
канал, 16-25 - канал красного цвета, 8—15 - канал зеленого цвета, 0-7 - канал 
синего цвета)». 

То есть в Ко т можно извлечь фактические значения каналов ВСВ и альфа, 
используя функцию, представленную в примере 2.56. 


Пример 2.36. Преобразование целого числа в значения КСВ 


Рип 1пЕ$РгомСо1ог(со\ог: Со1ог): [1$1<Тп{> { 
уа1 г96 = со1ог.гаЬ 0 
уа1 а\рпа = г9б $Вг 24 ап 9х @ 
уа\ гед гаь $Вг 16 апд 0х++ @ 
уа\ дгееп = гоб $Вг 8 апФ 0х+Р @ 
уа1 БЛие = гдЬ апд 9хЕЕ @ 
гефигп 11540(а\рНа, гед, дгееп, Бе) 


© Вызов /ауа-метода де{всв 


@ Сдвиг вправо и применение маски для извлечения соответствующего 
значения Тп* 


Возврат отдельных значений в виде списка позволяет использовать прием 
деструктуризации, как показано в примере 2.37. 


Пример 2.37. Деструктуризация и тестирование 


@Тез+ 
Рип `со\ог$ аз 11%5`() { 
уа1 со1ог = Со|1ог.МАСЕМТА 
уа\ (а, г, 9, 6) = 1пЕ$РгомСо\Тог( со1ог) 


аззегЕТВа{(со\ог.а1рва, едица\То(а)) 
аззегЕТВа{(со\ог.гед,  едиа\То(г)) 
аззегЕТВа{(со\ог.дгееп, едица1То(9)) 
аззегЕТВа{(со\ог.Бие, едиа1То(Ь)) 


Точно так же можно реализовать обратное преобразование значений ВСВ 
в целое число Тп\, как показано в примере 2.38. 


Пример 2.38. Создание |п{ из значений КСВ и альфа-канала 


Рип соТогЕгомТп$(а1рВа: Тпё, гед: Тпё, дгееп: Тпё, БЛие: Тп®) = 
(а1рНа апд ОхЕЁ $Р1 24) ог 
(гед  апФ 0хЕЁ $51 16) ог 
(дгееп апФ 0х $61 8) ог 
(ие апд 0хЕР) 


На этот раз значения сдвигаются влево, а не вправо. Эту функцию тоже легко 
проверить, как показано в примере 2.39. 
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Пример 2.39. Преобразование значений ВСВ и альфа-канала в |п{ 


@Тез+ 
Рип `1п65 а$ со1ог$`() { 
уа1 со\ог = Со|1ог.МАСЕМТА 
уа\ 1пЕСо1ог = со1огЕгомТп{$ ( соТог.а1рва, 
соТог.гед, со\ог.дгееп, со\ог.Бие) 
уа\ со\ог1 = Со1ог(1АпЕСо\ог, гие) ® 
аззегЕТВа{(со1ог1, едиа\То(со\ог)) 


© Второй аргумент конструктора сообщает, что определено значение альфа- 
канала 


В завершение этого рецепта представлю шутку о хог: «э-хог-цист устраня- 
ет одного или другого демона, но не обоих». Извините, если кого-то задел, но 
призываю вас: не стесняйтесь шутить над своими друзьями. 


2.9. СоздАНИЕ ЭКЗЕМПЛЯРОВ РАВ С ПОМОЩЬЮ {О 


Задача 


Создать экземпляры класса Ра\г (например, для включения в ассоциативный 
массив). 


Решение 


Вместо создания экземпляра класса Разг непосредственно используйте ин- 
фиксную функцию. 


Обсуждение 


Ассоциативные массивы состоят из элементов, которые являются комбинация- 
ми ключей и значений. Для создания ассоциативного массива в Кот имеет- 
ся несколько функций верхнего уровня, таких как птаро+, которые позволяют 
создать ассоциативный массив из списка экземпляров Ра\г. Вот как выглядит 
сигнатура функции паро#: 


Тип <К, \/> тар0Р(\агагд рафгз: Ра1г<К, \>): Мар<К, \> 
Ра1г — это класс данных, содержащий два элемента с именами Е1г${ и $есопд. 
Вот как выглядит объявление класса Ра\г: 
Чака с1аз$ Ра1\г<оце А, оц В> : Зелахае 
Свойства #1г5+ и 5есоп4 класса Ра1г соответствуют обобщенным значениям Аи В. 
Создать экземпляр класса Ра1г можно с помощью конструктора с двумя аргу- 


ментами, но чаще для этого используется функция фо. Функция о определена 
следующим образом: 


руБТАс 1пРАх Рип <А, В> А.Ко(+Ва*: В): Ра1г<А, В> = Ра1г(&РА5, Раф) 


Функция +0 просто создает экземпляр класса Ра\г. 
В примере 2.40 показано, как создать ассоциативный массив, используя 
пары, созданные с помощью функции то. 


х. 
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Пример 2.40. Использование функции {о для создания пар в вызове таро? 


@Тез+ 
Рип `сгеафе мар и$1пд 1пРАх фо Рипсоп`() { 
уа1 мар = мароЁ(“а” $0 1, “Б” 40 2, “с” {о 2) ® 
аззег%А ( 
{ аззегЕТра*(мар, ВазКеу("а")) }, 
{ аззегЕТра*(мар, ВазКеу("Ь")) }, 
{ аззегЕТВа*(мар, ВазКеу("с")) }, 
{ аззегЕТВа*(мар, Ваз\а\ие(1)) }, 
{ аззегЕТНае(тар, Ваз\а\ие(2)) }) 
} 


@Тез+ 

Рип `сгеа&е а Ралг Ёгом сопз%гисеог м$ фо Гипс оп`() { 
уа\ р1 = Разг(“а”, 1) 
уа1 р2 = “а” $0 1 © 


аззегфАД ( 
{ аззег&ТВа*(р1.РАг$&, `1$`("а")) }, 
{ аззегЕТвВа*(р1.есоп4, `1$`(1)) }, 
{ аззегЕТВае(р2.РАг$Е, `1$`("а")) }, 
{ аззегЕТва*(р2.5есоп4, `1$`(1)) }, 
{ аззегЕТВа*(р1, `15`(едиа\То(р2)))} 


© Создание экземпляров Ра\г с помощью {о 
@ Создание экземпляров Ра\г с помощью конструктора 


Функция то - это функция-расширение, добавляемая к любому обобщенно- 
мутипу а, которая имеет обобщенный аргумент В и возвращает экземпляр Ра\г, 
объединяющий значения А и В. Это всего лишь более удобный и компактный 


способ создания литералов ассоциативных массивов. 


Между прочим, поскольку Ра1г — это класс данных, доступ к его отдельным 
элементам можно получить с помощью приема деструктуризации, как показа- 


но в примере 2.41. 


Пример 2.41. Деструктуризация экземпляра Ра! 


@Тез& 

Рип `дез&гисфигАлд а Ра\фг`() { 
уа1 ра1г = “а” о 1 
уа1 (х,у) = раг 


аззегЕТВае(х, `45`(“а”)) 
аззегТВае(у, `15`(1)) 


В стандартной библиотеке имеется также класс ТгАр1е, представляю- 
щий триаду значений. Однако из-за отсутствия удобных функций- 
расширений создавать экземпляры ТгАр1е можно только непосред- 
ственно, вызывая конструктор с тремя аргументами. 


Глава 


Объектно-ориентированное 
программирование на Ко п 


Как и ]ауа, Кош является языком объектно-ориентированного программи- 
рования (ООП). Он позволяет определять классы, абстрактные и конкретные, 
и интерфейсы почти точно так же, как ]ауа. 

Некоторые аспекты ООП в Кот заслуживают особого внимания, и в этой 
главе мы познакомимся с ними поближе. Здесь вы найдете рецепты инициа- 
лизации объектов, реализации пользовательских методов чтения и записи 
свойств, выполнения поздней и отложенной инициализации, создания сингл- 
тонов (объектов-одиночек), применения класса №{Рлд и многие другие. 


5.1. РАЗЛИЧИЯ МЕЖДУ СОМ$Т И МАЕ 


Задача 


Определить значение, которое является константой времени компиляции, 
а не времени выполнения. 


Решение 


Использовать модификатор сопз{ для определения констант времени компиля- 
ции. Ключевое слово уа\ определяет переменную, которую нельзя изменить после 
инициализации, но эта инициализация может происходить во время выполнения. 


Обсуждение 


В Кош ключевое слово уа\ указывает, что значение переменной нельзя из- 
менить. В ]ауа аналогичную роль играет ключевое слово па\1. Но зачем Кот 
поддерживает еще и модификатор сопз{? 

Константы времени компиляции должны быть свойствами верхнего уровня, 
членами объекта или объекта-компаньона. Они должны иметь тип 5%г4пд или 
класса-обертки простого типа (Вуте, 5Ког\, Тп\, [опд, ЕЛоа{, ВочБЛе, СВаг или Воо\еап) 
и не могут иметь нестандартный метод чтения. Значения им должны присваи- 
ваться вне любой функции, включая пма\п, потому что их значения должны быть 
известны во время компиляции. 
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Давайте рассмотрим определение минимального и максимального приори- 
тетов для задачи, как показано в примере Зе: 


Пример 3.1. Определение констант времени компиляции 
СТа$$ ТазК(\а1 пате: 5%г4пд, _рглог\у: ТпЕ = ОЕРАЦЕТ_РЕТОВТТУ) { 

сотраплоп оБЗес* { 
соп$Е ма1 МТМ РЕТОВТТУ 


сопз{ ма1 МАХ_РЕТОВТТУ 
соп${ уа1 ОБЕРАЦЕТ_РВТОВТТ 


1 © 
5 © 
У=3 © 
} 


\уаг рг\логА у а 9РглогАу(_рглог у) @ 


= у 
ее (уа\ие) { 

Не = уаА9РглогА Ку (мае) 
} 


ргАмафе Фип уа\ААРглогАу(р: Тп®) = [3] 
р.соегсеТп(МТМ РЕТОВТТУ, МАХ_РАТОВТТУ) 


© Константы времени компиляции 

@ Свойство с нестандартным методом записи 

© Приватная функция проверки 

В этом примере три константы определены с использованием идиомы, 
обычной для Ко т (и ]ауа), согласно которой имена констант записывают- 
ся заглавными буквами. В этом примере также определен нестандартный 
метод записи для отображения любого переданного приоритета в заданный 
диапазон. 

Обратите внимание, что в Ко 1 уа1 - это ключевое слово, а соп5{ - модифи- 
катор, подобный модификаторам ргАмафе, 1пДпе и т. д. Вот почему сопз+{ следует 
использовать вместе с ключевым словом уа\, а не вместо него. 


Смотри также 


Рецепт 5:2, где подробнее рассказывается о методах записи, подобных пока- 
занному в этом рецепте. 


5.2. СОЗДАНИЕ НЕСТАНДАРТНЫХ МЕТОДОВ 
ЧТЕНИЯ И ЗАПИСИ СВОЙСТВ 


Задача 


Реализовать обработку значения перед присваиванием свойству или возвра- 
том из свойства. 


Решение 
Добавить к свойству класса функции деф и $е+{. 
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Обсуждение 


Так же как в других объектно-ориентированных языках, классы в Кот объ- 
единяют данные и функции, которые работают с этими данными, используя 
метод, широко известный как инкапсуляция. Но, в отличие от других языков, 
в Ко т все члены класса по умолчанию являются общедоступными. В резуль- 
тате создается впечатление, что язык нарушает принцип сокрытия данных, 
согласно которому структура данных, связанная.с информацией, считается де- 
талью реализации. 

Кот решает эту дилемму необычным способом: поля нельзя объявлять 
непосредственно в классах. Это звучит странно, особенно если учесть воз- 
можность определения свойств, которые выглядят точно так же, как поля 
(см. пример 3.2). 


Пример 3.2. Класс, представляющий задачу 


СТа$$ Та$К(\уа{ пате: 5%г4пд) { 
уаг рг\ог1фу = 3 


ДИ ок 


Класс ТазК определяет два свойства: имя (папе) и приоритет (рг\ог\ ху). Пер- 
вое свойство объявляется в главном конструкторе, а второе является чле- 
ном класса верхнего уровня. Конечно, оба свойства можно было определить 
в конструкторе, но в данном случае я хотел показать альтернативный син- 
таксис. Недостаток такого объявления рглог\{у - невозможность назначить 
приоритет при создании экземпляра класса, однако его легко преодолеть 
с помощью блока арр\у: 


уаг муТазК = ТазК().арр\у { рглогл\у = 4 } 


Преимущество подобного способа определения свойства - возможность до- 
бавить свои методы чтения и записи свойства. Вот полный синтаксис опреде- 
ления свойства: 
уаг <ргорег+уМаме>[: <Ргорег+уТуре>] [= <ргорег%у 4п а тег] 

[<дееег>] 
[<се{ег>] 


Выражение инициализации и методы чтения (зеКег) и записи (зе(цег) мож- 
но опустить. Определение типа тоже можно опустить, если его можно опреде- 
лить из выражения инициализации или из типа, возвращаемого методом чте- 
ния. Но все это не относится к свойствам, объявленным в конструкторе. 


Объявления свойств в конструкторе обязательно должны включать 
определение типа, даже если указаны значения по умолчанию. 


В примере 3.5 показан метод чтения, вычисляющий значение свойства 
15 омРгтог\ у. 


62 4% Объектно-ориентированное программирование на Кот 


Пример 35.3. Метод чтения для свойства 


уа1 1$ оиРгтогл фу 
9еЕ() = рглог\\у < 3 


Как уже говорилось, тип 1$ЁомРглог Ку определяется автоматически по типу 
значения, возвращаемого функцией де*, - в данном случае это логический тип. 

Метод записи автоматически вызывается прижаждой попытке присвоить зна- 
чение свойству. Например, чтобы гарантировать, что приоритет находится в диа- 
пазоне от 1 до 5, можно реализовать метод записи! как показано в примере 3.4. 


Пример 3.4. Метод записи для свойства 


маг рг\фог1еу = 3 
зеЕ(уа\ие) { 
{1е19 = уа\ше.соегсеТп(1..5) 
} 


Здесь, наконец, можно видеть решение упомянутой выше дилеммы общедо- 
ступных/приватных полей. Обычно, когда объекту требуется вспомогательное 
поле, Кош создает его автоматически. Однако в этом нестандартном методе 
записи для ссылки на поле, соответствующее свойству, используется иденти- 
фикатор #4е19. Идентификатор #1е14 можно использовать только в нестандарт- 
ных методах чтения и записи. 

Поле создается для свойства, только если оно применяется в созданном по 
умолчанию методе чтения или записи или если в нестандартном методе чте- 
ния или записи используется ссылка #4е14. Это означает, что у вычисляемого 
свойства ТоиРглог\ у такого поля не будет. 


В литературе методы чтения и записи формально называются ме- 
тодами доступа и мутации, по-видимому, потому что сложно брать 
плату за консультации, если использовать более простые термины 
чтение и запись. 


Чтобы заверитить этот пример, представьте, что вам потребова- 
лась возможность назначать приоритет в вызове конструктора. Один из спо- 
собов сделать это - добавить параметр конструктора, который не является 
свойством, исключив ключевое слово уаг или уа\. В результате получается сле- 
дующее определение класса ТазК, показанного выше в примере 3.1: 


СТа$$ ТазК(\уа1 пате: 5%г4пд, _рглоглеу: ТпЕ = ОЕРАЦЕТ_РЕТОВТТУ) { 


сотраплоп оБЗесЕ { 
сопзЕ ма\ МТМ РЕТОВТТУ = 1 
соп${ уаф МАХ_РВТОВТТУ = 5 
соп${ уа1 ОБЕРАЦЕТ_РВТОВТТУ = 


3 
} 


\уаг рглогАЕу = уаПААРг\логАу(_рглог у) 
ее (уа\ие) { 


Не\9 = уаА9Рглог\ Ку (мае) 
} 


ргАмафе Фип уа\ААРглогАу(р: Тп®) = 
р.соегсеТп(МТМ РЕТОВТТУ, МАХ _РАТОВТТУ) 
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Параметр _рглог\&у - это не свойство, а просто аргумент конструктора. 
Он используется для инициализации фактического свойства рг\лог\\у, а нестан- 
дартный метод записи будет приводить его-значение в допустимый диапазон 
при каждой попытке изменения. Обратите внимание, что имя уа\ше - это всего 
лишь фиктивное имя; вы можете использовать любое другое, какое вам понра- 
вится, как и для параметров любых функций. 


Смотри также 
Рецепт 3.1, демонстрирующий использование констант. 


5.5. ОПРЕДЕЛЕНИЕ КЛАССОВ ДАННЫХ 


Задача 


Определить класс, представляющий сущность, имеющий полный комплект 
методов едица\$, ВазНСоде, ко5%гАлпд и т. д. 


Решение 
Использовать ключевое слово даф*а в объявлении класса. 


Обсуждение 


В Кот имеется ключевое слово да{а, позволяющее указать, что данный класс 
предназначен для хранения данных. В ]ауа такие классы, представляющие ин- 
формацию, например из таблиц в базе данных, называют сущностями. Классы 
данных в Ко т имеют аналогичное назначение. 

Добавление слова дата в`определение класса заставляет компилятор автома- 
тически сгенерировать целый ряд функций, включая согласованные функции 
едца1$ и ВазНСоде, функцию +05%г4лпд, которая преобразует класс и значения его 
свойств в строку, функцию сору и функции доступа к компонентам для под- 
держки деструктуризации. 

Например, рассмотрим класс Ргодис*: 

Чафа с\а$$ Ргодис®( 
уа1 паме: 5г\1лд, 


уаг рг4се: БоиЛе, 
уаг опба\е: Воо1еап = Фа\5$е 


На основе свойств, объявленных в главном конструкторе, компилятор сгене- 
рирует функции едца\$ и ВазАСоде, используя алгоритм, аналогичный алгоритму, 
описанному Джошуа Блохом (]озБиа В]осп) много лет назад в книге «ЕНесйуе 
Гауа»5 (АЧ1зоп-Ме$еу РгоЁе$$1опа]). Тесты в примере 3.5 показывают, что они 
работают правильно. 


5 


Джошуа Блох. ]ауа. Эффективное программирование. Лори, 2014. 1$ВМ: 978-5-85582- 
347-9. - Прим. перев. 
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Пример 3.5. Использование сгенерированных реализаций едца[5 и ПазНСоде 


@ТезЕ 
Рип `спесК едш\уа\епсе`() { 
уа\ р1 = РгодисЕ(“БазеБа\1”, 10.0) 
уа\ р2 = Ргодисе(“БазеБа\1”, 10.0, Ра\$е) 


аззегЕЕдиа1$(р1, р2) 
аззег{Едуа1$(р1.Ва$АСоде(), р2.ВазАСоде()) 
} 


@ТезЕ 
Рип `сгеафе зеф фо сВесК едиа\$ апд Вазсоде`() { 
уа\ р1 = РгодисЕ(“БазеБа\1”, 10.0) 
уа\ р2 = РгодисЕ(рглсе = 10.0, опба\е = Ка\$е, пате = “БазеБа1”) 


уа\ ргодис{$ = зе 0{(р1, р2) 
а5зегЕЕдиа1$(1, ргодис$.$12е) ® 


© Лубликат не будет добавлен 


Поскольку экземпляры р1 и р2 эквивалентны, то при передаче их в вызов 
функции 5е10{ она добавит в возвращаемую коллекцию только один из них. 
Функция +051г1пд преобразует экземпляр Ргодис{ в строку: 


Ргодис* (пате=Базера\1., рг1се=10.0, опба\е=Ра\5е) 


Метод сору — это метод экземпляра, который создает новый объект, копируя 
значения свойств из оригинала и изменяя только указанные свойства, как по- 
казано в примере 3.6. 


Пример 3.6. Тестирование функции сору 


@ТезЕ 
Рип `сПапде рглсе и$1пд сору`() { 
уа\ р1 = РгодисЕ(“БазеБа\1”, 10.0) 
уа\1 р2 = р1.сору(рглсе = 12.09) © 
аззег%А ( 
{ аззегЕЕаца1.$("БазеБа11", р2.паме) }, 
{ аззегЕТВа*(р2.рг4се, `1$`(с10$еТо(12.0, 0.01))) }, 
{ аззегЕРа\$е(р2.опба\е) } 


© Изменит только цену (рг4се) 


Тест проверяет, действительно ли вызов сору с параметром рг\се изменит 
только это значение. Обратите внимание, что для сравнения используется 
функция с1озеТо из библиотеки Натсгез*, потому что проверка равенства 
значений с плавающей запятой с помощью оператора сравнения - не луч- 
шая идея. 

Обратите внимание, что функция соруедздает лишь поверхностную копию. 
Для демонстрации этого поведения опредёлим еще один класс данных с име- 
нем ОгдегТ{ет, как показано в примере 3.7. 


х. 
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Пример 3.7. Класс, содержащий экземпляр РгодисЕ 
Чафа с1аз$ ОгдегТ%ет(уа\ ргодисе: РгодисЕ, ма манат у: ТпЕ) 
Тест в примере 3.8 создает экземпляр!/ОгдегТ*еп и затем получает его копию 
с помощью функции сору. 
Пример 3.8. Тест, демонстрирующий поверхностное поведение функции сору 


@Тез+ 

Рип `Фафа сору Кипс\оп 1$ зпаДом`() { 
уа\ 14ет1 = ОгдегТ%ет(Ргодис{(“БазеБа\1”, 10.0), 5) 
уа\ 14ет2 = 1{ет1.сору() 


аззег% АД ( 
{ аззегЕТгие(1{ет1 == 1%епт2) }, 
{ аззегЕРа\е(4+ем1 === 44ем2) }, © 


{ аззегЕТгие(1{ет1.ргодисЕ == \{ет2.ргодис®) }, 
{ аззегЕТгие(\{ем1.ргодисе === \{ет2.ргодис®) } @ 


© Экземпляр Огдег1*ет, созданный функцией сору, — это другой объект 
@ Свойства ргодис+ в обоих экземплярах Огдег1Т*епт ссылаются на один и тот 
же объект Ргодис+ 


Этот тест показывает, что, несмотря на эквивалентность двух экземпляров 
ОгдегТ*ет (проверяется с помощью функции едиа\$, которая вызывается опера- 
тором ==), они являются разными объектами, потому что оператор ссылочного 
равенства === возвращает #а15е. Однако они оба ссылаются на один и тот же 
экземпляр Ргодис*, поскольку === для внутренних ссылок возвращает {гие. 


Функция сору в классах данных выполняет поверхностное копиро- 
вание, а не глубокое. 


Кроме функции сору, классы данных автоматически получают функции 
с именами сотропеп{1, сотропепЕ2»и т. д., которые возвращают значения свойств. 
Эти функции используются для деструктуризации, как показано в примере 3.9. 


Пример 3.9. Деструктуризация экземпляра РгодисЕ 


@Тез+ 
Рип `Фез{гисеиге и51п9 сомропепЕ Рипс\оп$`() { 
уа1. р = РгодисЕ(“БазеБа\1”, 10.0) 


уа\ (паме, рглсе, за\е) = р © 

аззег{А ( 
{ аззегЕЕаца1$(р.паме, паме) }, 
{ аззегЕТВа*(р.рг4се, `1$`(с1о$еТо(рглсе, 0.01))) }, 
{ аззегЕРа1е(за\е) } 

) 


© Деструктуризация экземпляра Ргодис* 
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Любую из этих функций (едиа1$, пазКСоде, +о5%г1пд, сору, а также любую из 
функций _сопропеп\№_) можно переопределить. Также можно добавить другие 


функции. 


Если необходимо, чтобы значения свойств обрабатывались сге- 
нерированными функциями, добавляйте свойства в тело класса, 
а не в главный конструктор. 


Классы данных - это удобный способ определения объектов, главной целью 
которых является хранение данных. Стандартная библиотека включает два 
класса данных, Ра\г и ТгАр1е, для хранения двух и трех свойств любых типов соот- 
ветственно. Если вам потребуется больше свойств, создайте свой класс данных. 


5.4. ПРИЕМ СОЗДАНИЯ ТЕНЕВОГО СВОЙСТВА 


Задача 


Обеспечить возможность управлять инициализацией и чтением общедоступ- 
ного свойства класса. 


Решение 


Определить второе свойство того же типа и реализовать свои методы чтения 
и записи, предоставляющие доступ к требуемому свойству. 


Обсуждение 


Представьте, что у вас есть класс Сизфотег, представляющий клиента, и вам нуж- 
но организовать хранение списка его сообщений или заметок. Однако необя- 
зательно загружать все сообщения при создании экземпляра, поэтому класс 
можно определить, как показано В-примере 3.10. 


Пример 3,10. Класс Си$отег, версия 1 


СТа$$ Сиз{отег(\ма1 паме: $4г1па) { 
ргА\уафе маг _меззадез: [451<5%г4п9>? = пи ® 


\уа1 меззаде$: 1154<5%г1п9> [2 
9е*() { [3] 
АЕ (пеззаде$ == пи1.) { 
_ме5задез = Тоа4Мез$аде$() 
} 


гефигп _те$5адез!! 


} 


ргАмафе Фип Тоа4Ме$$адез(): МифаБе11$1<5%г4п9> = 
миа \е11$4042( 
“ТП а сопфасе”, 
“Сопу\псеф {Рем о изе Ко{11п”, 
“5014 {га1п1па с1а$$. бмее{.” 
).а150 { ргаплп(“Гоа4деФ мез$задез”) } 
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© Приватное свойство, поддерживающее значение п 1 и используемое 
для инициализации 


@ Свойство, при обращении к которому производится загрузка 
© Приватная функция 


Свойство мез5адез в этом классе хранит список сообщений данного клиента. 
Чтобы избежать его немедленной инициализации, добавляется дополнитель- 
ное свойство _птеззадез того же типа, но с поддержкой значения пи 1. Нестан- 
дартный метод чтения загружает сообщения, если прежде они не были загру- 
жены. Тест в примере 3.11 проверяет загрузку сообщений. 


Пример 3.11. Проверка загрузки сообщений в объекте, представляющем клиента 


@Тез+ 

Рип `1оад меззадез`() { 
уа\ сизфомег = Сизфомег(“ЕРгед”).арр\у { меззадез } ® 
аззег{Едуа1$(3, сизфомег.теззаде$.$17е) [2] 


© Загрузит сообщения при первой! попытке обращения к свойству меззадез 
@ Повторное обращение к свойству пеззадез, но сообщения уже загружены 


Загрузить сообщения, используя свойство конструктора, нельзя, потому что 
_те5задез является приватным свойством. Если необходимо, чтобы сообщения 
загружались немедленно, используйте функцию арр\у, как показано в этом 
примере. Здесь использование арр\у приводит к вызову метода чтения, кото- 
рый загружает сообщения и выводит информационное сообщение. При вто- 
ром обращении к свойству меззадез сообщения уже загружены и информаци- 
онное сообщение не выводится. 

Это очень интересный пример, но в действительности он реализует от- 
ложенную загрузку. Код будет выглядеть намного проще, если использовать 
встроенную функцию-делегат 1а2у, как показано в примере 3.12. 


Пример 3.12. Отложенная загрузка сообщений с использованием [агу 


СТа$$ Сиз{отег(уа1 паме: $4г1па) { 
уа1 меззаде$: 1154<5%г1п9> Бу Тату { \оа4Меззадез() } ® 


ргАмафе Фип Тоа4Ме$$аде$(): МифаБе11$+<5%г4п9> = 
миа \е11$401( 
“Тооа| сопфасе”, 
“Сопу\псеф {Рем о изе Ко{11п”, 
“5014 {га1пАпа с1а$$. 5мее{.” 
).а150 { ргаплп(“Гоа4деФ мез$задез”) } 


© Использование делегата 1а7у 


И все же прием принудительной инициализации свойства с использовани- 
ем приватного теневого поля стоит запомнить. 

Другая разновидность этого приема состоит в том, чтобы определить пара- 
метр конструктора для установки значения и при этом обеспечить соблюдение 
ограничений для свойств, как было показано в примере 3.1, код из которого 
повторяется ниже для простоты: 
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СТа$$ ТазК(\а{ пате: 5%г4пд, _рглог\у: ТпЕ = ОЕРАЦЕТ_РЕТОВТТУ) { 


сотраплоп оБдес* { 
соп$Е ма1 МТМ_РЕТОВТТУ = 1 
соп${ уаф МАХ_РВТОВТТУ = 5 
соп${ уа1 БЕРАЦЕТ_РВАТОВТТУ = 


3 
] 


\уаг рглогАЕу = уаПААРглогАу(_рглог у) 
зе (уа\ие) { 
Не\9 = уаА9Рглого у (мае) 


| 


ргАмафе Фип уа\ААРглогАу(р: Тп®) = 
р.соегсеТп(МТМ_РЕТОВТТУ, МАХ_РВТОВТТУ) 


Обратите внимание, что _ргАог\ ху объявлено без ключевого слова уа\,то есть 
это обычный параметр конструктора, а не фактическое свойство класса. Фак- 
тическое свойство рглог\{у имеет свой метод записи, который присваивает 
свойству значение аргумента конструктора. 

Прием использования теневых свойств довольно часто встречается в клас- 
сах Кот, поэтому стоит потратить время, чтобы понять, как он работает. 


Смотри также 
Рецепт 8.2, где обсуждается делегат Тару. 


5.5. ПЕРЕГРУЗКА ОПЕРАТОРОВ 


Задача 


Дать возможность клиентам использовать операторы, такие как + и *, с экземп- 
лярами библиотечных классов. 


Решение 


Использовать механизм перегрузки операторов в Ко 1 и реализовать необхо- 
димые функции. 


Обсуждение 


Многие операторы, включая сложение, вычитание и умножение, реализованы 
в Ко т как функции. Когда в исходном коде вы используете символы +, - или *, 
то на самом деле делегируете работу этим функциям. То есть, определив ана- 
логичные функции для своих классов, вы дадите возможность клиентам ис- 
пользовать операторы. 

В документации приводится классический пример - реализация функции- 
члена ипагуМлпи$ в классе Ро\п\, как показано в примере 3.15. 


х. 
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Пример 3.13. Переопределение оператора чпагуМ\пи$ в классе Ро\п* (пример из докумен- 
тации) 


Чафа с1а$$ Ро1пЕ(\уа1 х: Тпё, уа1 у: Тпё) 
орегафог Фип Ро\пе.ипагуМАпи$() = Ро\п(-х, -у) 
уа\ ро1пЕ = Ро1п{(10, 20) 

Рип ма\л() { 


ргап 1п( -ро1пЕ) // выведет: «Ро1п(х=-10, у=-20)» 
} 


Ключевое слово орегафог обязательно должно использоваться при 
переопределении любых функций-операторов, кроме едиа\$. 


А можно ли добавить сбответствующие функции в чужой класс? Да, можно, 
но в этом случае функциядолжна определяться как функция-расширение. 

Возьмем для примераЛкласс Сотр\ех из ]ауа-библиотеки Арасбе Сотлилоп$ 
Ма, который представляет комплексное число (с действительной и мнимой 
частями). Как сообщает документация ]ауа4ос$з, этот класс включает такие ме- 
тоды, как а44, зиб%гасе и пу р1у. В языке Кот операторам +, - и * соответству- 
ют функции р\из, тпуз и мез. Если добавить функции-расширения для Сотр\ех, 
которые будут вызывать существующие методы, как в примере 3.14, то вы смо- 
жете использовать операторы. 


Пример 3.14. Функции-расширения для Сотр(ех 


1троге огд.араспе. соммоп$ .ма{ВЗ. сотр\ех.Сомрех 


орегафог Фип Сотр\ех.р\и$(с: Сотр\ех) = ЕВ1$.а99(с) 
орегафог Фип Сотр\ех.р\и$(9:ПВоур1е) = [1$ .а99(9) 
орегафог Фип Сотр\ех.мАпи$ (с: Сотр\ех) = В1$.зибЕгас*(с) 
орегафог Фип Сотр\ех.мАпи$(9: БоуБе) = 41$. зибЕгас* (9) 
орегафог Фип Сотр1ех.4А\(с: ‘Сотр®ех) = &В1$.ЧАм1де(с) 
орегафог Фип Сотр\ех.04\1\(9: бочБЛе) = +В1$.9\/4е(9) 
орегафог Фип Сотр\ех. {1мез(с: Сотр\ех) = {1$ . пи ЕАрТу(с) 
орегафог Фип Сотр\ех.{1тез(9: БоиБе) = {1$ . пи ЕАр1у(9) 
орегафог Фип Сотр\ех.{1мез(1: ТпЕ) = 41$. пи АрТу(1) 
орегафог Фип боуЛе.+{1тез(с: Сотр\ех) = с.пу рту (В1$) 
орегафог Фип Сотр\ех.ипагуМ\пиз() = {11$ .педа{е() 


Все эти функции-расширения вызываютсуществующие методы в ]ауа-классе. 
Тест в примере 3.15 показывает, как использовать эти функции-операторы. 


Пример 3.15. Использование операторов с экземплярами Сотр(ех 


1троге огд.араспе. соммоп$ .ма{ВЗ. сотр\ех.Сомрех 
Атроге огд. арасВе.соттоп$ .тмаЕНЗ .сотр\ех.Сомр1ех.* ® 


1троге огд.Катсгез*.МафсНегАззеге. аззег{ТНа{ 
1трог огд.Катсгез*.Мафсвег$.`15` 

1троге огд.Ратсгез* .МафсНег$ . с1озеТо 

1трогЕ огд. ип. дир\{ег.ар\.Тез* 
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Атроге огд. и пт. )ир\ег.ар\.Аззег\оп$.* 
4трог )а\а.Тапда.МаВ.* [2 


1пфегпа\ с1а$$ Сотр\ехОуег1оаЧОрегафогК{Тез{ { 
ргАмафе ма1 РАг${ = Сотр\ех(1.0, 13400) 
рг\уафе уа\ зесоп@ = Сотр\ех(2.0, 5.0) 


@Те$+ 
Апеегпа1 Фип р1и$() { 

уа1 зим = РАг$Е + зесопд 

аззегЕТВа{(зим, `1$`(Сотр\ех(3.0, 8.0))) 
} 


@Те$+ 
1пеегпа1 Фип м1пи$() { 
уа\ АТР = зесопд - РАг$& 
аззег(ТВае (91+, `1$`(Сотр\ех(1.0, 2.0))) 


} 


@Те$& 
1пеегпа1 Фип педафе() { 
уа\ п1пиу$1 = -ОМЕ ® 


аззег{ТВа{(т1пу$1.геа1, с1озеТо(-1.0, 0.000001)) 
аззег(ТВа{(т1пу$1.1мад\1пагу, с1о$5еТо(0.0, 0.000001)) 


} 


@Те$& 
1пфегпа1 Фип `Е\\ег’$ Когми\а`() { 
уа\ 1РТ = Т*РТ ® 


азег{Тгие(Сотр\ех.едиа1.$(ДРТ.ехр(), -ОМЕ, 0.000001)) 
} 


© Импортирование Сопр\ех.* позволяет сократить Сомр1ех.0МЕ до ОМЕ 

@ Ссылки Соптр1ех.Т и Ма В .РТ можно сократить до ТиРТ 

В последнем тесте функция ехр класса Сопр\ех вернет значение е^{агд}, то есть 
этот тест фактически иллюстрирует формулу Эйлера, е^{1 * РТ} == -1. 

Тесты демонстрируют множество перегруженных операторов. Если вы пи- 
шете на Кот и используете класс Сопр\ех, то, потратив совсем немного време- 
ни на создание коротких функций-расширений, сможете использовать те же 
операторы, что и с обычными числами. 


5.6. ОТЛОЖЕННАЯ ИНИЦИАЛИЗАЦИЯ С ПОМОЩЬЮ ТАТЕМТ 


Задача 


Отложить инициализацию свойства на более позднее время, если в момент 
вызова конструктора отсутствует информация, необходимая для этого. 


Решение 
Использовать модификатор Та{е\1п1{ в объявлении свойства. 
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Обсуждение 


Не злоупотребляйте этимприемом. Он может пригодиться, напри- 
мер, для внедрения зависимостей, как описывается в этом рецепте, 
но в общем случае предпочтительнее использовать другие альтер- 
нативы, такие как отложенные, или ленивые, вычисления, о кото- 
рых рассказывается в рецепте 8.2. 


Предполагается, что свойства класса, объявленные как не поддерживающие 
значение п 1, будут инициализированы в конструкторе. Однако иногда в мо- 
мент вызова конструктора недостаточно информации, чтобы определить зна- 
чение для такого свойства. Это обычная ситуация для фреймворков внедрения 
зависимостей, в которых внедрение происходит только после создания всех 
объектов, и для методов настройки модульных тестов. В таких случаях можно 
объявить свойство с модификатором Тате\т +. 

Например, фреймворк 5рипе использует аннотацию @Ац+ом\гед для присваи- 
вания значений зависимостям из так называемого контекста приложения. По- 
скольку значение устанавливается после создания всех экземпляров, свойство 
следует объявить с модификатором Тате1та+, как показано в примере 3.16. 


Пример 3.16. Тестирование контроллера 5р/пд 


@бргАпоВоо{Тез{(мерЕпу\гоптепЕ = ЭргАпдоВоо{Тез*.мерЕпу\гоптепе.ВАМООМ_РОВТ) 
СТа$$ ОРРАсегСопегоДегТе${$ { 

@Ацфомл.гед 

Тафе1тАЕ уаг слеп: мебТезеС\Тепе © 


@АцеоиАгед 
ТафелтпАЕ уаг геро$\Фогу: ОЕРАсегВеро$А4огу ® 


@Вефоге 
Рип зе{Ир() { 

геро$\огу.аЧ4Тез«ата() @ 
} 


@Те$+ 

Рип `СЕТ фо гоц%е гефигп$ а. о Рсег$ 4п 95`() { 
сИепе.дее().иг\(“/гоце”) [3 
// ... получить и проверить данные ... 


} 


// ... другие тесты... 


о Инициализация с использованием механизма автоматического связы- 
вания 


@ Использование репозитория в функции настройки 
© Использование клиента в тестах 
Модификатор Та*е1п\{ можно применять только к уаг-свойствам, объявлен- 


ным в теле класса, и только если свойство не имеет нестандартных методов чте- 
ния и записи. Начиная с версии Кот 1.2 1афе\гАЕ также можно применять к свой- 
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ствам верхнего уровня и даже к локальным переменным. Типы таких свойств 
не должны поддерживать значение пи] и не могут быть простыми типами. 

Добавляя модификатор Тафе\1п\{, высобещаете инициализировать перемен- 
ную перед ее первым использованием. Нсли вы нарушите это обещание, про- 
грамма сгенерирует исключение, каййбказано в примере 3.17. 


Пример 3.17. Особенности поведения свойств с модификатором |а{етй 


СТаз$ [афеТп\О0ето { 
Тафе1п1{ уаг пате: 5%г4лпд 


} 


СТаз$ [а{еТп\ЕОетоТез{ { 
@Те$+ 
Рип ‘па 27ед Тафелп1{ ргорегфу Вгои$ ехсер\оп`() { 
аззегЕТВгои$<Ип\ п Та 7е9Ргорег{уАссезЕхсер\оп> { 
[а еТп1Оето().паме 
} 
} 


@Те$& 

Рип `зе{ё {Ре Тафелил1е ргорегфу ап по ехсерАоп 1$ ЕВгоип`() { 
аззег(бое$Мо{ТАгом { ГафеТп\Оемо().арр1у { паме = “Бо\Ду” } } 

} 


Попытка обратиться к свойству папе до того, как оно будет инициализировано, 
вызовет исключение Ип1п{1а12е4РгорегеудссеЕхсер1оп, как показывает тест. 

Внутри класса есть возможность проверить, былогли свойство инициализи- 
ровано, обратившись к свойству 1511 аЦтед, которым обладает проверяемое 
свойство, как показано в примере 3.18. 


Пример 3.18. Использование 15| аИтеа для проверки инициализации свойства 


СТаз$$ [афеТп\ ето { 
Тафе1п1{ уаг пате: 5%г4лпд 


Рип ла 2еМаме() { 
ргп л(“Вефоге а5$19птепе: ${: :паме.1$1п141а117е4}”) 
паме = “Мог14” 
ргАп п (“АРег а$$19пмепе: $4: : паме.1$Тп Та тед}”) 


} 


Рип тафп() { 
ГафеТп1Оето(). Ап Та12еМаме() 
} 


Если запустить этот пример, его функция 1п Па 2еМате выведет следующее: 


ВеРоге аз$1дпмеп{: Ка15е 
АЁЕег а5$19птепе: {гие 
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Сравнение [эм{етК и [а2у 


Модификатор Тафе\1п1 Е может применяться только к уаг-свойствам и наклады- 
вает некоторые ограничения, перечисленные выше в этом рецепте. Делегат 
1агу принимает лямбда-выражение, которое вычисляется при первом обра- 
щении к свойству. 

Используйте Та2у, если для инициализации необходимо выполнить дорого- 
стоящие вычисления и она может никогда не потребоваться в программе. 
Кроме того, 1агу можно использовать только для уа1-свойств, а Тафе\па{ - 
только для уаг-свойств. Наконец, свойства с модификатором Та%е1п1{ можно 
инициализировать в любом месте, где это свойство доступно, даже за преде- 
лами объекта, как показано в одном из предыдущих примеров. 


Смотри также 
Рецепт 8.2, где обсуждается делегат Тару. 


5.7. Использовадние ‘хпеРАТОРОВ БЕЗОПАСНОГО 
ПРИВЕДЕНИЯ ТИПА, ССЫЛОЧНОГО РАВЕНСТВА И «Элвис» 
ДЛЯ ПЕРЕОПРЕДЕЛЕНИЯ МЕТОДА ЕОЧА!$ 


Задача 


Реализовать свою версию метода еаца15 в классе, чтобы ПОЛУЧИТЬ ВОЗМОЖНОСТЬ 
проверять эквивалентность его экземпляров. 


Решение 


Использовать вместе операторы ссылочного равенства (===), безопасного при- 
ведения типа (а$?) и «Элвис» (2:). 


Обсуждение 


Все объектно-ориентированные языки поддерживают понятия эквивалентности 
и равенства объектов. В ]ауа оператор == проверяет равенство ссылок на объекты. 
Метод едиа1$ класса ОБ3ес*, напротив, проверяет эквивалентность двух объектов. 

В Кот оператор == автоматически вызывает функцию едуца15. Открытый 
класс Апу объявляет функцию едиа\$, как показано в примере 3.19, атакже функ- 
ции ВазНСоде и ко5г\пд. 


Пример 3.19. Объявления методов едиа(5, ПаНСоде и т05/пд в классе Апу 


ореп с1а5$ Апу { 
ореп орегафог Рип едца1$(о{Вег: Апу?): Воо\еап 


ореп Рип Па$КСоде(): ТпЕ 


ореп Рип $054г1п9(): 5Ег1п9д 
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Контракт метода едиа1$ требует, чтобы реализация была рефлексивной, 
симметричной и транзитивной, а также надлежащим образом обрабатывала 
значения п Ц. Контракт метода ПазАСоде требует, чтобы для эквивалентных 
(с точки зрения функции едца1$) объектов он возвращал одинаковые хеш- 
коды. Функцию ВазНСоде необходимо переопределять всегда, когда переопре- 
деляется функция едиа\5. 

Итак, как правильно реализовать хорошую функцию едиа1$? Отличным при- 
мером может служить библиотечный класс Ко Ап\егз\оп, функция едца1$ кото- 
рого показана в примере 3.20. 


Пример 3.20. Функция едчца[5 из класса КоИп\ег!оп 


оуегг14е Кип едца1$(о{Вег: Апу?): Воо1еап { 
АЕ (4515$ === офрег) гефигп гие 
уа1 о{Рег\ег$1оп = (офНег а$? Ко Алп\ег$1оп) ?: гефигп Фа\$е 
гефигп ЕВ1$.\ег$1оп == оНег\ег$\оп.мегз\оп 


Обратите внимание на простоту и элегантность реализации, которая ис- 
пользует некоторые особенности Кот: 


О сначала проверяется равенство свылок с помощью ===; 

О затем используется операторбезопасного приведения типа аз?, который 
приводит аргумент к указанному типу или возвращает пи\1; 

О если оператор безопасного приведения типа вернет п, то оператор 
«Элвис» (?:) вернет #а15е, потому что экземпляры разных классов не мо- 
гут быть эквивалентными; 

О наконец, последняя строка проверяет (с помощью оператора ==) эквива- 
лентность свойства уег$1оп текущего экземпляра и аналогичного свой- 
ства другого объекта и возвращает результат. 

Три строки кода охватывают все возможные случаи. Для полноты обсужде- 

ния ниже приводится реализация Ва$АСоде: 


оуегг14е Рип ВазНСоде(): Тпё = мег$\оп 


Она представляет определенный интерес, но не помогает понять, как на- 
писать свою функцию едиа\/Допустим, что у вас есть простой класс Си отег со 
строковым свойством папе. В примере 3.21 показаны подходящие реализации 
функций едца\$ и ВазНСоде для такого класса. 


Пример 3.21. Реализация едца[5 и ВазНСоде в Сизотег 


СТа$$ Сиз{фотег(\ма1 паме: 54г4пд) { 


оуегг\4е Рип едиа1.5(оВег: Апу?): Воо\еап { 
14 (451$ === офЛег) гефигп гие 
уа\ офпегСизфотег = (о{Нег аз? Сизфомег) ?: гефигп Фа\$е 
гефигп Е№1$.паме == офНегСиу$фомег .пате 


} 


оуегг\4де Рип БазВСоде() = пате.ВазНСоде() 


х. 
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Между прочим, если позволить среде разработки Пие!] ШЕА самой сге- 
нерировать реализацию едца\$ и ВазНСоде, то в результате вы получите функ- 
ции (при использовании версии Отае Е оп 2019.2), показанные в при- 
мере 3.22. 


Пример 3.22. Функции едца6 иа$ПСоае, сгенерированные в |п{еЦ 1РЕА 


СТа$$ Сиз{отег(\ма1 паме: $&г1па) { 
оуегг\4е Рип едиа1.5(оЕВег: Апу?): Воо\еап { 
44 (4515$ === офНег) гефигп гие 
4Е (ауаСТа$$ != офВег?. )ауаСТаз5) гефигп Фа\зе 


о{Вег а$ Сизфомег 


44 (пате != оНег.пате) гефигп Фа1.5е 
гефигп фгие 


} 


оуегг\4е Кип Ба$ВСоде(): Тпё { 
гефигп пате.Ва$АСоде() 
} 


Сгенерированная функция едца1з проверяет эквивалентность свойств 
)ауаСТаз$ перед приведением типа с помощью оператора аз, а затем полага- 
ется на результат интеллектуального приведения для проверки свойств папе. 
Фактически этот код эквивалентен коду, показанному выше, только немного 
подробнее. 

Классы данных получают свои, сгенерированные автоматически реализа- 
ции едца\$ и ВазВСоде (а также методы {05%г4пд, сору и сотропеп+М№). Однако, как 
можно видеть, реализация своих версий этих функций не представляет ника- 
ких сложностей. 


Смотри также 


Рецепт 3.3, где обсуждаются классы данных. Рецепт 11.1, где показана версия 
класса Ко 1п\ег$\оп. 


5.8. СозДАНИЕ СИНГЛТОНА 


Задача 


Гарантировать, что во время выполнения в программе будет существовать 
не более одного экземпляра класса. 


Решение 
Использовать ключевое слово о5)ес* вместо с\аз$. 


Обсуждение 


Шаблон проектирования «Синглтон» (Зтеоп) определяет механизм, га- 
рантирующий, что во время выполнения в программе будет существовать 
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не более одного экземпляра_ланного класса. Чтобы определить синглтон, 

нужно: 

1) объявить все конструкторы класса приватными; 

2) реализовать статический фабричный метод, возвращающий ссылку на эк- 
земпляр класса и создающий его, если необходимо. 


Шаблон проектирования «Синглтон» - довольно неоднозначный, потому что 
иногда он используется в ситуациях, когда вместо одного вполне можно было 
бы использовать несколько экземпляров класса. Тем не менее это один из фун- 
даментальных шаблонов проектирования, описанных Эрихом Гаммой (Е1сВ 
Сатита) с соавторами в книге «Оез1еп Ра{еги$»6 (АЯ! оп-Ме3еу РгоЁе$$1опа]), 
и в некоторых случаях может быть очень полезен. 

Примером синглтона в стандартной библиотеке ]ауа может служить класс Вип- 
ле. Допустим, вам нужно узнать, сколько процессоров доступно на данной плат- 
форме. В ]ауа для этого можно использовать код, показанный в примере 3.25. 


Пример 3.25. Определение числа процессоров 


Рип пафп() { 
уа\ ргосе$$ог$ = Вип 1ме.де{Вип\те().ауаЛаБЛеРгосе$$ог$() 
ргАп 1п(ргосе$$ог$) 


де{Вип ме — это статический метод, возвращающий синглтон (единствен- 
ный экземпляр) класса. В примере 5.24 показана соответствующая часть 
класса )ауа.1апд.Вип\ле. 


Пример 3.24. Реализация шаблона проектирования «Синглтон» в классе Кипите 


ру Ас с1а$$ Вип ме { 
рг\\афе зас РАпа\ Виплме сиггепЕВип ме = пем Вип \име(); 


руб Ас зас ВипЕАме дефВипЕАме() { 
гефиугп сиггеп Вип ме; 
} 


[** Запретить создавать экземпляры класса любым другим способом */ 
рг\уаее Вип1ме() {} 


лы 


Класс Вип те содержит приватный, статический, конечный экземпляр клас- 
са, который создается в момент инициализации атрибута сиггеп{Вип ле. Един- 
ственный конструктор объявлен приватным, а статический фабричный метод 
де{Вип те просто возвращает ссылку на единственный экземпляр, как показа- 
но в примере 3.24. 

Чтобы реализовать шаблон «Синглтон» в Кот, достаточно просто исполь- 
зовать ключевое слово оБ}ес+ вместо с\а5$, как показано в примере 3.25. Это 
называется обзявлением объекта: 


° Гамма Эрих, Хелм Ричард, Джонсон Ральф, Влиссидес Джон. Паттерны объектно- 


ориентированного проектирования. Питер, 2020. 15ВМ: 978-5-4461-1595-2. -— 
Прим. перев. 


х. 
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Пример 3.25. Реализация шаблона «Синглтон» в Кот 


оБ]есЕ Муб1паТеоп { 
уа1 пуРгорегфу = 3 


Рип муРипсТоп() = “Нео” 


Если декомпилировать байт-код, сгенерированный для этой программы, 
получится результат, представленный в примере 3.76. 


Пример 3.26. Декомпилированный байт-код реализации синглтона с помощью ключевого 
слова об] ес 


руБАс РАпа{ с1а$$ Муб\Аподееоп { 
рг\\афе зас РАпа\ 1пЕ пуРгорег\у = 3; 
руБ\Ас зас РАпа1 Муб\па1ефоп ТМ№5ТАМСЕ; ® 


рг\уафе Му5\по1ефоп() { @ 
} 


риуБ\Ас РАпа\ 1пЕ дефМуРгорегфу() { 
гефигп пуРгорегфу; 


} 


руБ\Ас ЕАлпа1 019 муРупсоп() { 
гефигп “Нео”; 


} 

фас { 
Муб1па\1ефоп уаг0 = пем Му$\па\ефоп(); © 
Т№5ТАМСЕ = уаг0; 
пуРгорег\%у = 3; 

} 


© Сгенерированное свойство ТМ5ТАМСЕ 
@ Приватный конструктор 
9 Создание экземпляра синглтона 


При работе с синглтоном можно обращаться к его членам по имени объекта, 
так же как к статическим членам в ]ауа. Функции-члены и свойства становят- 
ся статическими конечными методами и атрибутами в декомпилированном 
классе ]ауа, наряду с любыми методами чтения, а сами свойства инициализи- 
руются в статическом блоке вместе с классом. В примере 3.27 приводится код 
на Кот, демонстрирующий приемы доступа к членам объекта. 


Пример 3.27. Доступ к членам синглтона в Кот 


Музтпд1етоп . туРупсЕТоп() 
Муз1пд1етоп .туРгорегеу 


В Га\а для доступа к синглтону используется обобщенное свойство ТМ№5ТАМСЕ, 
как показано в примере 3.28. 
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Пример 3.28. Доступ к членам синглтона в )ауа 


Музтпд\етоп . ТМ5ТАМСЕ .муРипсТоп(); 
Музтпа1е{оп . ТМ5ТАМСЕ .де{МуРгорег%у(); 


Сложность появляется, когда возникает необходимость создать синглтон 
саргументом. Скажем, вы реализуете пул соединений с базой данных, который 
является естественным синглтоном. При создании пула было бы хорошо иметь 
возможность передать параметр, определяющий начальный размер пула. К со- 
жалению, объект оБ)ес+ в Кот не может иметь конструктора, поэтому нет 
простой возможности передать ему аргумент. 


В своей статье «Кош Зшеот$ м Атгэитет&» (БЕрз://оте|.Ду/ 
РЗОСУ) Кристоф Бейлс (СБиз{юорВе Веу!5) обсуждает способы обра- 
ботки аргументов на основе реализации делегата Тагу в библиотеке 
Кот. 


В указанной статье также рассказывается о сложностях безопасного созда- 
ния синглтонов в многопоточной среде из-за необходимости использовать 
блокировки с двойной проверкой и @\/о1а Це. 


5.9. Много шУМА ИЗ НИЧЕГО 


Задача 
Использовать класс №*1\пд идиоматическим способом. 


Решение 
Использовать №*В\пд в функциях, которые никогда не возвращают управления. 


Обсуждение 


Теперь ты знаешь, что такое Мот, Джон Сноу. 
— Игритт, Игра престолов, похвала Джону Сноу за чтение этого рецепта 


В Кот есть класс №*1\Алпд, полная реализация которого приведена в приме- 
ре 3.29. 


Пример 3.29. Реализация М№о{Итд 


раскаде Ко Ап 
рус с1а$$ Мо{В\па ргАмафе соп$гис®ог() 


Так как конструктор объявлен приватным, экземпляр класса не может 
быть создан за пределами класса, и, как видите, он также не создается 
и внутри класса. То есть экземпляров №+{\пд не существует. В документации 
говорится, что «№ 1пд можно использовать для представления несуществу- 
ющих значений». 

Класс №№ лд имеет два естественных применения: когда тело функции пол- 
ностью состоит из инструкции возбуждения исключения, как в примере 3.30. 
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Пример 3.30. Возбуждение исключения в Ко п 


Рип до№{РАп9(): №11 пд = Вгом Ехсер{\оп(“М№ {пд а а”) 


Тип возвращаемого значения должен быть указан явно, а поскольку этот 
метод никогда не возвращает управления (вместо этого он генерирует исклю- 
чение), то тип возвращаемого им значения объявлен как №+*19. 

Это практически гарантированно запутывает разработчиков на ]ама. В ]ауа, 
если метод вызывает исключение любого типа, тип значения, возвращаемого 
методом, не изменяется. Обработка исключений происходит за рамками обыч- 
ного потока выполнения, но вам не нужно изменять тип возвращаемого зна- 
чения метода. Система типов в Ко] т, однако, предъявляет другие требования. 

Другое естественное применение №+*\лд — когда переменной, объявленной 
без типа, присваивается значение пи, как в примере 3.31. 


Пример 3.31. Переменной, объявленной без типа, присваивается значение пи 


уа1 х = пи 1 


В этом тип переменной х будет определен как №*№л9?, потому что он явно 
поддерживает значение пи\1 (котороелрисваивается переменной) и компиля- 
тор не имеет никакой другой информации. 

Ситуация становится особенно интересной, если вспомнить, что в Кот 
класс № па фактически является подтипом любого другого типа. 

Чтобы понять, почему это необходимо, рассмотрим оператор 1+, который 
может вызвать исключение (пример 3.52). 


Пример 3.32. Оператор №, который может вызвать исключение 


уа1. х = 14 (Вапдот.пех{Воо\еап()) “гие” е\$е ЕВгом Ехсер{\оп(“поре”) 


Тип х может быть определен как 5%г4пд, Сотрага\е<54г1пд>, СВагедиепсе, 
бег1а117аЛе или даже Апу, в зависимости от строки, возвращаемой опера- 
тором, когда функция Вапдот. пех{Воо1еап сгенерирует истинное логическое 
значение. Предложение е\15е возвращает значение типа №+*В\пд, а поскольку 
Мо РАпд является подтипом каждого типа, логическая операция «И» с ним 
и любым другим типом возвращает этот другой тип. 

Возможно, следующий пример поможет придать обсуждению дополни- 
тельную ясность. Остаток от деления любого числа на 3 может быть равен 0, 1 
или 2. Следовательно, оператору ивеп в примере 3.35 не нужно предложение 
е\зе, но компилятор этого не знает. 


Пример 3.33. Остаток от деления на 5 


Рог (пап 1..10) { 
уа\ х = ипеп (п % 3) { 
9 -> “бп %З == 0” 
1 -> "51% 3 == 1” 
2 -> 51% 3 == 2” 
е15е -> Егои Ехсер1оп(“Ноиз оп, ме Вауе а ргоБЩею...”) 


} 


аззег{Тгие(х 1$ $1г1пд) 
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Конструкция ийеп возвращает значение, поэтому компилятор требует, чтобы 
оно было исчерпывающим. Условие е|5е в данном случае никогда не должно 
выполняться, поэтому имеет смысл сгенерировать исключение. В случае ис- 
ключения возвращаемым типом будет №+1\лпд, а в остальных случаях - тип 
5%г1пд, поэтому компилятор будет знать, что х имеет тип 5+г\пд. 


Функция 1000 (обсуждается'в "рецепте 11.9) возвращает тип №+*Н\пд, 
и в этом есть определенный смысл, потому что ее реализация гене- 
рирует исключение №+Тпр\етепеедЕггог. 


Класс №{\пд может сбивать с толку, но после знакомства с вариантами ис- 
пользования он становится простым и понятным. 


Глава 


Функциональное 
программирование 


Термин «функциональное программирование» описывает стиль, поощряющий 
использование неизменяемых элементов данных, упрощающий реализацию 
алгоритмов параллельных вычислений с использованием чистых функций, 
использующий преобразования вместо циклов и фильтры вместо условных 
операторов. В этой книге функциональные подходы используются повсюду, 
особенно в главах 5, 6 и 13. Многие функции в Кот, такие как пар и Рег, об- 
суждаются по мере встречи с ними в отдельных рецептах в этих и других главах. 

Эта глава представляет рецепты, которые используют приемы функцио- 
нального программирования, уникальные для Кот (в отличие от ]ауа), на- 
пример хвостовую рекурсию, илиреализованные несколько иначе, к примеру 
функции +014 и гедисе. 


4.1. Использование кгогш‚о вв дЛГОРИТМАХ 


Задача 
Реализовать итеративный алгоритм функциональным способом. 


Решение 


Использовать функцию Ро14 для свертки последовательности или коллекции 
в единственное значение. 


Обсуждение 


Функция {014 выполняет операцию свертки и может применяться к массивам 
и итерируемым объектам. Вот как выглядит определение функции: 
АпИле Фип <В> Г(егаЛе<Т>.Ко19( 
лат: В, 
орега{\оп: (асс: В, Т) -> В 
): В 


Эта функция также определена в классе Аггау и во всех типизированных мас- 
сивах, таких как Тп*Аггау, БочБ1еАггау и т. д. 
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Функция №014 принимает два параметра: начальное значение для аккуму- 
лятора и функцию двух аргументов, которая возвращает новое значение для 
аккумулятора. Классический пример использования +014 - вычисление суммы 
(см. пример 4.1). 


Пример 4.1. Вычисление суммы целых чисел с помощью То[Я 


Рип зим(уагагд питз: Тпё) = 
пим$ . Ро19(0) { асс, п -> асс +т } 


В этом случае начальное значение равно 0, а лямбда-выражение, передавае- 
моев функцию, принимает два аргумента, первый из которых является аккуму- 
лятором. Второй выполняет итерации по всем значениям в списке параметров. 
Тест в примере 4.2 показывает, что эта функция вычисляет верный результат. 


Пример 4.2. Тестирование функции ит 


@ТезЕ 

Рип `5им и$1п9 #019`() { 
уа1 пимбег$ = 1п%Аггауо{(3, 1, 4, 1, 5, 9) 
аззег{Едуа1.$(питрег$.зит(), зит(*пимЬег$)) 


Результат, полученный функцией зип, сравнивается с результатом, полу- 
ченным методом зип класса Тп*Аггау. Этот тест показывает, что наша функция 
работает правильно, но не помогает понять, как именно она работает. Чтобы 
получить более полное представление, добавьте оператор рг\4п& для наблюде- 
ния, как происходит обход значений, как показано в примере 4.5. 


Пример 4.3. Функция ит, которая выводит каждое значение 


Рип зи" ЕРТгасе(уагагд пим$: Тп®) = 
пим$ . Ро19(0) { асс, п -> 
рглп л(“асс = Фасс, п = $1”) 
асс + п 


} 


Если вызвать ее стеми же аргументами, как в тесте выше, она выведет: 


асс = 0, 
асс = 3 
асс = 4, 
асс = 8 
асс = 9 
асс = 14, 


р = = д = = 
1 
©юиврво 


Переменная асс инициализируется первым аргументом функции +014, пере- 
менная п последовательно получает”значение каждого элемента коллекции, 
и в каждой итерации в асс записывается результат лямбда-выражения асс + п. 

Само лямбда-выражение является двухместным оператором, потому что 
типы данных аккумулятора, каждого элемента коллекции и возвращаемого 
значения одинаковы. 


Хотя первый аргумент функции +014 называется 1 {а1 и инициа- 
лизирует аккумулятор, технически это должно быть значение иден- 
тичности для лямбда-операции. 
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Более интересный пример: вычисление факториала целого числа. Эту опе- 
рацию легко выразить с использованием рекурсии, с которой мы снова встре- 
тимся в примере 4.10: 

Рип гесиг$\уеРаског\ла1 (п: 1079); Вл9Тпфедег = 
мвеп (п) { 
0, 11 -> ВлаТпедег.ОМЕ 
е15е -> В19Тп(едег.уа\ие0 (п) * гесиг$А\\уеРаског\ла\(п - 1) 


} 


Эту операцию можно реализовать итеративным способом, с использовани- 
ем №014, как показано в примере 4.4. 


Пример 4.4. Реализация факториала с использованием №0{4 


Рип Расфог1а\Ро19(п: 1019): Вл9Тп%едег = 
мвеп(п) { 
0, 1Е -> Вл9Тпеедег.0МЕ 
е\15е -> (2..п).Ро19(Вл9Тпедег.ОМЕ) { асс, 1 -> 
асс * ВА9Тп(едег.уа\ие0{(1) } 


Условие иреп проверяет входной аргумент, и если он равен 0 или 1, то воз- 
вращает В19Тпедег.ОМЕ. Условие е15е использует диапазон от 2 до п (значения 
входного аргумента) и применяет операцию 1014, которая получает начальное 
значение В19Тпфедег .ОМЕ. В каждой итерации лямбда-выражение присваивает ак- 
кумулятору произведение предыдущего значения аккумулятора на каждое по- 
следующее значение. И снова, В19Тпедег .ОМЕ является не только начальным зна- 
чением аккумулятора, но также значением идентичности операции умножения. 

Рассмотрим еще один увлекательный пример использования +014 - вычис- 
ление последовательности чисел Фибоначчи, в которой каждое следующее 
число является суммой двух предыдущих. В примере 4.5 показано, как реали- 
зовать этот алгоритм с помощью 1014. 


Пример 4.5. Вычисление чисел Фибоначчи с помощью {а 


Рип ЕАБопасс\Ро19(п: Тпё) = 
(2 чп п).Р019(1 60 1) { (ргем,/сигг), _ -> 
сигг Фо (ргеу + сигг) }.зесопд 


В этом случае начальным значением аккумулятора является экземпляр 
Ра1г, свойства Е4г5+ и зесоп4 которого равны 1. Соответственно, лямбда-вы- 
ражение может создать новое значение для аккумулятора, не обращая вни- 
мания на конкретный индекс, поэтому в качестве заполнителя для этого зна- 
чения используется подчеркивание ( _). Лямбда-выражение создает новый 
экземпляр Ра1г, присваивая текущее значение предыдущему и делая новое 
значение сигг равным сумме предыдущего и текущего значений. Этот про- 
цесс повторяется от 2 до указанного индекса п. В конце значение свойства 
зесопд последнего экземпляра Ра\г представляет результат. 

Еще одна интересная особенность этого примера - тип аккумулятора отли- 
чается от типа элементов в диапазоне. Аккумулятор - это Ра\г, а элементы - 
значения типа Тп+. 

Последний пример показывает, что #019 обладает намного более широкими воз- 
можностями, чем можно подумать, рассматривая типовой пример с функцией 5им. 
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Смотри также 


Рецепт 4.3, где повторно рассматривается задача вычисления факториала. Ре- 
цепт 4.2, где вместо #014 используется функция гедисе. 


4.2. Использование ‹ху‚КкцИИ ВЕФУСЕ ДЛЯ СВЕРТКИ 


Задача 


Требуется свернуть непустую коллекцию значений, не указывая начальное 
значение для аккумулятора. 


Решение 
Использовать функцию гедисе вместо о\4. 


Обсуждение 


Функция гедисе похожа на +014, обсуждавитуюся в рецепте 4.1. Вот как выглядит 
ее определение в Т*егаЩе: 


АпИле Фиуп <5, Т : 5> ЦегаЛе<Т>.гедисе( 
орега{1оп: (асс: 5, Т) -> 5 

уни 

Функция гедисе действует почти так же, как #019, и используется для той же 
цели. Ее самое большое отличие - она не имеет аргумента, предоставляющего 
начальное значение аккумулятора. Она инициализирует аккумулятор первым 
значением из коллекции. 

В примере 4.6 показана реализация гедисе в стандартной библиотеке. 


Пример 4.6. Реализация функции гедисе 


руБ\Ас 1пИлпе Фип ТпеАггау. гедисе( 
орега{1оп: (асс: Тпф, Тпё) -> Тю): Тпё { 
АЕ (15$Етрфу()) 0 
ЕВгом ИпзиррогЕедОрегаопЕхсер*\оп( 
“Етр®у аггау сап’+ Бе гедисед.”) 
уаг ассимиТафог = {11$[0] [2 
Фог (1пдех 4п 1..1а$Тпдех) { 
ассити1афог = орега\оп(ассити\а%ог, №15 [1пдех]) 


} 


гефигп ассипуТафог 


© Для пустой коллекции генерируется исключение 
@ Аккумулятор инициализируется первым элементом коллекции 


Соответственно, функцию гедисе можно использовать, только когда коллек- 
ция содержит хотя бы одно значение и есть возможность инициализировать 
аккумулятор. Примером использования гедисе может послужить та же опера- 
ция суммирования, представленная ранее в примере 4.1.В примере 4.7 демон- 
стрируется ее реализация с использованием гедисе. 
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Пример 4.7. Реализация функции ит с помощью гедисе 


Рип зимВедисе(уагагд пим$: Тпе) = 
пит$ .гедисе { асс, \ -> асс +1 } 


Если эту функцию вызвать с несколькими аргументами, первый из них ини- 
циализирует аккумулятор, а остальные будут последовательно прибавляться 
к нему. Если эту функцию вызвать без аргументов, она возбудит исключение, 
как показано в примере 4.8. 


Пример 4.8. Тестирование функции ит, реализованной с помощью гедисе 


@ТезЕ 
Рип `сим и$51п9 гедисе`() { 
уа1 пимбег$ = 1п%Аггауо{(3, 1, 4, 1, 5, 9) 
аззег{АД ( 
{ аззегеЕаца\$(питбег$.зим(), зимВедисе(*пимЬег$)) }, ® 
{ аззегЕТАгои$<Ипзиррог%едОрега{опЕхсер\оп> { 
с<имВедисе() 
} [2] 
> 


© Проверка массива значений ТпЕ 
@ Вызов без аргументов сгенерирует исключение 


Функция гедисе имеет еще одну тонкость, которая может стать причиной 
ошибки. Допустим, вы решили удвоить все входные значения перед суммиро- 
ванием. Решение, напрашивающееся само собой, показано в примере 4.9. 


Пример 4.9. Удваивание элементов коллекции перед суммированием 


Рип зитВедиседоч1е$(\магагд пимз: Тпё) = 
пит$ .гедисе { асс, 1 -> асс+2* 1} 


Попытавшись суммировать значения {3, 1, 4, 1, 5, 9}, одновременно ото- 
бражая значения аккумулятора и переменной 1, получаем: 
асс=3, 1=1 
асс=5, 1=4 
асс=13, 1=1 
асс=15, 1=5 
асс=25, 1=9 


огд.ореп{е${4) .Аззег1опРаДедЕггог: 
Ехрескед :46 
Асфиа\ :43 


Результат получился ошибочным, потому что число 3 - первое значение 
в списке - использовалось для инициализации аккумулятора и не было удвое- 
но. Для этой операции уместнее было бы использовать +014, а не гедисе. 


Используйте гедисе, только когда допустимо инициализировать 
аккумулятор первым значением коллекции и для других значений 
не выполняется никакая дополнительная обработка. 
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В Гауа потоки определяют метод гедисе, имеющий две перегруженные 
версии. Одна принимает двухместный оператор (здесь используется лямб- 
да-выражение), а другая - начальное значение, подобно функции 1014. Кро- 
ме того, версия без начального значения возвращает тип Ор опа1, то есть 
вместо возбуждения исключения в пустом потоке ]ауа возвращает пустой 
экземпляр Ор\1опа\. 

Разработчики библиотеки Кот предпочли реализацию с двумя отдельны- 
ми функциями и генерировать исключение, если гедисе применяется к пустой 
коллекции. Работая с ]ауа, помните об этих различиях, когда будете выбирать, 
какую функцию использовать. 


Смотри также 
Рецепт 4.1, где обсуждается функция 1019. 


4.5. ХвостоваЯ РЕКУРСИЯ 


Задача 


Имеется рекурсивный алгоритм и требуется уменьшить потребление памяти 
этим алгоритмом. 


Решение 


Выразить алгоритм с использованием хвостовой рекурсии и добавить ключе- 
вое слово фа гес в определение функции. 


Обсуждение 


Разработчики склонны отдавать предпочтение итеративным алгоритмам, по- 
тому что их проще понять и запрограммировать. Однако некоторые проце- 
дуры проще выразить с использованием рекурсивного алгоритма. В качестве 
тривиального примера рассмотрим вычисление факториала числа, как пока- 
зано в примере 4.10. 


Пример 4.10. Рекурсивная реализация вычисления факториала 


Рип гесиг$\меРаскогла\(п: 1019): Вл9Тп%едег = 
мреп (п) { 
0, 11 -> В1аТп%едег.ОМЕ 
е1.5е -> В19Тпедег.уа\ие0Р(п) * гесиг$\уеРас®огла\(п - 1) 


з 


Идея проста: факториалы чисел 0 и 1 равны 1 (0! == 1,1! == 1), а факто- 
риал каждого числа больше 1 равен произведению этого числа на факториал 
числа, которое на единицу меньше данного. Поскольку результат растет очень 
быстро, в этом примере в качестве типа возвращаемого значения используется 
класс В19Тптедег, даже притом что аргумент имеет тип [опд. 

Каждый новый рекурсивный вызов добавляет новый кадр в стек вызовов, 
поэтому есть риск, что процесс исчерпает доступную память. Тест, демонстри- 
рующий это, показан в примере 4.11. 
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Пример 4.11. Тестирование рекурсивной реализации факториала 


@Тез+ 
Рип `сбесК гесигзАме ФКасфогта\`() { 
аззег%А ( 
{ аззегЕТВа*(гесигз\меРас®ог\1а1(0), `15`(В19Тпедег.0МЕ)) }, 
{ аззегЕТВа*(гесигз\меРас®ог\а1(1), `1$`(В19Тпедег.0МЕ)) }, 
{ аззегЕТНае(гесиг$АмеРас®ог\1а1.(2), `1$`(ВлаТпфедег.уа\ие0{(2))) }, 
{ аззегЕТва*(гесиг$\меРас®ог\а1(5), `15`(В\9Тпфедег .уа\ие0{(120))) }, 
{ аззегЕТНгои$<5{асКО\уег\омЕггог> { гесигз\меРасфог1а1(10_000) }} ® 
) 
} 


© Достаточно большое число, чтобы вызвать переполнение стека 5+аск- 
ОуегТомЕггог 


Виртуальная машина ]УМ потерпит аварию с ошибкой $%асКОуег юомЕг- 
гог, как только процесс исчерпает память, отведенную для стека вызовов 
(в Ореп]ПК 1.8 по умолчанию имеет объем 1024 Кбайт). 

Подход, известный как хвостовая рекурсия, - это частный случай рекурсии, 
который можно реализовать без добавления новых кадров в стек вызовов. Для 
этого алгоритм нужно переписать так, чтобы рекурсивный вызов был послед- 
ней выполняемой операцией и появилась возможность повторно использо- 
вать текущий кадр стека. 

В примере 4.12 показана версия реализации вычисления факториала, кото- 
рую можно преобразовать в хвостовую рекурсию. 


Пример 4.12. Реализация факториала с хвостовым рекурсивным вызовом 


@)утОуег1оа4$ о 
фа гес Фип Расфогта\(п: 1опд, [2] 
асс: ВА9Тпеедег = В19Тп{едег.ОМЕ): В19Тпфедег = 
ибеп (п) { 
0. -> В19Тпедег.ОМЕ 
1 -> асс 


е|5е -> Расбогла\(п - 1, асс * Вл9Тпеедег.уа\ие0+(п)) ® 


-> 


© Аннотация, позволяющая вызывать функцию из ]ауа с единственным 
аргументом 


@ Используется ключевое слово фаДгес 
© Хвостовой рекурсивный вызов 


В этом случае функции Рас%ог1а\ нужен второй аргумент, играющий роль ак- 
кумулятора. Благодаря такой организации последнее вычисленное выражение 
может вызвать самого себя с меньшим числом и увеличенным аккумулятором. 

Для второго аргумента определено значение по умолчанию В\9Тп*едег .ОМЕ, и по- 
скольку этот аргумент имеет значение по умолчанию, функцию Фас*ога1 можно 
вызывать без него. Так как ]ауа не поддерживает аргументов со значениями по 
умолчанию, аннотация @)мт0уег1оад$ помогает обеспечить подобную возможность. 

Однако самое главное заключается в добавлении ключевого слова та гес. 
Без этого компилятор не сможет оптимизировать рекурсию. После примене- 
ния этого ключевого слова функция становится быстрой и эффективной ите- 
ративной версией. 
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Ключевое слово фа гес сообщает компилятору о необходимости 
оптимизировать рекурсивный вызов. Тот же алгоритм, выраженный 
на ]ауа, по-прежнему останется рекурсивным и будет иметь те же 
ограничения в отношении памяти. 


Тесты в примере 4.13 показывают, что теперь функции можно передать на- 
столько большое число, что тест просто проверяет количество цифр в ответе. 


Пример 4.13. Тестирование реализации с хвостовой рекурсией 


@Тез& 
Рип `ГасфоглаТ %е$515`() { 
аззег%А1Д ( 
{ аззегЕТВа*(Раског\1а1(0), `1$`(Вл9Тпкедег.0№)) }, 
{ аззегЕТВа*(Расог\1а1(1), `1$`(ВАаТпкедег.0№)) }, 
{ аззегЕТВае(Раског\1а1(2), `1$`(ВАдТп%едег.уа\ие0{(2))) }, 
{ аззегЕТра*(Касог1а1(5), `1$`(ВлаТпеедег.уа\ие0{(120))) }, 
Даа 
{ аззегЕТВае(Касфог\а1(15000) . Ео$4г1п9().1епдеН, `1$`(56130)) }, ® 
{ аззегЕТВае(Касфог\а1(75000) . о$г1п9().1епдЕН, `15`(333061)) } ® 
) 


© Проверяется количество цифр в результате 


Если сгенерировать байт-код из реализации на Кош и декомпилировать 
его в ]ауа, то получится результат, показанный в примере 4.14. 


Пример 4.14. Код )ауа, декомпилированный из байт-кода Ко{Ип 


руб Ас зас РАпа\ ВлаТпфедег Гасфогла1(Топд п, В\9Тпфедег асс) { 
мА Це( гие) { 
В19Тп{едег гези\*; 
АЕ (п == 01) { 
гези\{ = Вл9Тп%едег.о№; 
} е\е { 
АЕ (п != 11) { 
геи { = гези\*.пи А рТу(ВА9Тпкедег .уа\ие0{(п)); 
пей - 11; 
соп\пие; 
} 
} 


гефигп гези1{; 


Рекурсивный вызов был преобразован компилятором в итеративный алго- 
ритм с использованием цикла ип Це. 

В заключение отметим, какими свойствами должна обладать функция, что- 
бы к ней можно было применить модификатор ка гес: 


О рекурсивный вызов должен быть последней операцией; 
О аЦгес нельзя использовать внутри блоков {гу/саесв/лпаЦу; 
О хвостовая рекурсия поддерживается только на уровне ] УМ. 


Глава 


Коллекции 


Каки ]ауа, Кот тоже поддерживает типизированные коллекции для хранения 
наборов объектов. Но, в отличие от ]ауа, Кош добавляет в классы коллекций 
множество интересных методов. 

Рецепты в этой главе обсуждают приемы работы с массивами и коллекция- 
ми, начиная от сортировки и поиска и заканчивая созданием представлений 
только для чтения, доступом к диапазонам данных и т. д. 


5.1. РАБОТА С МАССИВАМИ 


Задача 
Создать и заполнить массив на Кот. 


Решение 


Использовать функцию аггауо{ для создания массивов, а свойства и методы 
класса Аггау —- для работы со значениями, содержащимися в массивах. 


Обсуждение 


Практически все языки программирования поддерживают массивы, и Кот 
не исключение. В этой (книге основное внимание уделяется использованию 
Кот в ]УМ, но в ]ауа массивы обрабатываются немного иначе, чем в Кот. 
В ]ауа экземпляр массиваеёоЗдается с помощью ключевого слова пем и размер- 
ности массива, как показано в примере 5.1. 


Пример 5.1. Создание массива в /ауа 


54г4п9[] $%г1п9$ = пем 5%г1п9[4]; 
$г1п9$[0] = “ап”; 

$г1п9$[1] = “аггау”; 

$4г119$[2] = “оЁ”; 

$4г1п9$[3] = “5г4п9$”; 


// или еще проще, 
${Г1п45 = «ап аггау оф $%г1пд$». р Е(« «); 
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Кот предлагает для создания массивов простой фабричный метод 
аггауо{. И хотя для доступа к элементам массивов используется тот же син- 
таксис, тип Аггау в Кош - это класс. Пример 5.2 показывает, как работает 
фабричный метод. 


Пример 5.2. Использование фабричного метода аггауОР 


2266 


уа\ $1г1пд$ = аггау0{(“ВА$”, “15”, “ап”, “аггау”, “ор”, “${г4пд$”) 


Также можно использовать фабричный метод аггауо №, чтобы полу- 
чить массив (как нетрудно догадаться), содержащий только пи1, как показано 
в примере 5.3. 


Пример 5.3. Создание массива с элементами, содержащими значение пиЦ 


уа\ пи115г4пдАггау = аггауо№11.5<5г4п9>(5) 


Обратите внимание: даже притом что массив содержит только значения 
пиЦ, вы все еще должны выбрать для него конкретный тип данных. В конце 
концов, не будет же он вечно хранить значения пиЦ, и компилятор должен 
знать, ссылки какого типа вы планируете добавлять в него. Аналогично дей- 
ствует фабричный метод епрфуАггау. 

Класс Аггау имеет только один общедоступный конструктор. Он принимает 
два аргумента: 


О 512е типа ТпЕ; 
О пы, лямбда-выражение типа (Тп{) -> Т. 


Лямбда-выражение вызывается для каждого элемента. В примере 5.4 пока- 
зано, как создать массив строк, содержащий строковые представления квадра- 
тов пяти первых целых чисел. 


Пример 5.4. Массив строк, содержащий строковые представления квадратов целых чисел 
от 0 до 4 


уа\ з4цагез = Аггау(5) {4 -> (1 * 1).1054г4пд() } ® 
© Получится массив: {«0», «1», «4», «9», «16»} 


Класс Аггау объявляет общедоступные методы де* и зе{ оператора [], кото- 
рые вызываются при попытке обратиться к элементу массива с использовани- 
ем квадратных скобок, например $4цаге$[1]. 

В КоИш имеются специальные классы, представляющие массивы простых 
типов и помогающие избежать затрат на автоматическую упаковку и распа- 
ковку. Функции Боо\еапАггау0{, Бу{еАггауо{, Пог+Аггау0{, свагАггау0, 1п{Аггауот, 
ТопдАггауоТ, Тоа{Аггауо{? и дочБЛеАггауо{ создают массивы соответствующих ти- 
пов (Воо1еапАггау, Ву{еАггау, 5Ног{Аггау И т. д.). 


Несмотря на то что Кот не имеет явной поддержки простых 
типов, сгенерированный байт-код использует классы-обертки 
на ]ауа, такие как Тп*едег и Боч\е/ если элементы массива могут 
принимать значения пи 1, и простые типы, такие как 1п{ и доуТе, 
если нет. 


5.1.Работа с массивами *% 91 


Массивы имеют практически тот же набор методов-расширений, что и кол- 
лекции, о которых рассказывается в оставшейся части этой главы. Однако есть 
пара методов, присущих только массивам. Например, метод 4п44сез позволя- 
ет узнать допустимые значения индексов для данного массива, как показано 
в примере 5.5. 


Пример 5.5. Получение допустимых значений индексов в массиве 


@ТезЕ 

Рип `уа1149 1пд1сез`() { 
уа\ $1г1п9$ = аггау0+(“Е1$”, “15”, “ап”, “аггау”, “о”, “${г4пд$”) 
уа1 1п91сез = $&г1п9д$.1п91сез 
аззегЕТВа{(1п\Асез, сопфа1п$(9, 1, 52553, 4, 5)) 


Перебор элементов массивов ‘обычно осуществляется с помощью цикла Ююг- 
ш, но при желании то же самое можно сделать с применением значений ин- 
дексов, используя функцию и Тпдех. 


ип <Т> Аггау<оц* Т>.и\АТпдех(): Т4&ега\е<Тпдехед\а1ие<Т>> 


Чака с1а$$ Тпдехед\/а\1ие<оие Т>(риБЛАс уа1 1п4дех: Тп\, 
риБ\Ас уа1 уа\ие: Т) 


Класс Тпдехед\а\ие — это класс данных с двумя свойствами: \1пдех и ма\ше. 
В примере 5.6 показано, как можно использовать его. 


Пример 5.6. Доступ к значениям в массиве с помощью у/паех 


@Тез+ 
Рип `иЕАТпдех гефигп$ Тпдех\а\иез`() { 
уа\ $1г1п9$ = аггауб+(“ЕР1$”, “15”, “ап”, “аггау”, “о”, “$4г4пд$”) 
Ког ((1пдех, уа\ие) 4п $Ег1пдз.мАЕРТпдех()) { о 
ргАп п ("Тпдех $Ап4дех тарз №0 $уа\ше") @ 
а$зег{Тгие(1пдех 1п 0..5) 


© Вызов и(НТпдех 
@ Обращение к отдельным индексам и значениям 
Этот тест выведет следующие строки: 


Тпдех © марз фо [1$ 


Тпдех 1 мар$ о 1$ 
Тпдех 2 марз о ап 
Тпдех 3 мар$ фо аггау 
Тпдех 4 марз %о оЁ 


Тпдех 5 мар$ фо $&г1пд$ 


В общем и целом массивы в Кот действуют так же, как в других языках. 
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5.2. СОЗДАНИЕ КОЛЛЕКЦИЙ 


Задача 
Сгенерировать список, множество или ассоциативный массив. 


Решение 


Использовать одну из функций для создания неизменяемых коллекций, такую 
как 1150, зе{0Р и таро, или их изменяемых эквивалентов: мифа \е!1 $401, пифаБ- 
Тебе{0?т и пифаБЛеМаро+. 


Обсуждение 


Пакет Ко Ап. соЦес\оп$ предлагает ряд вспомогательных функций для созда- 
ния неизменяемых коллекций. 

Одна из них - функция 11510#(уагагд е1емепЕ$: Т): 1151<Т>, реализация кото- 
рой показана в примере 5.7. 


Пример 5.7. Реализация функции И${ОР 


рус Кип <Т> 11540 (уагагд е\емеп{$: Т): [15$1<Т> = 
АЕ (е|етепф$.512е > 0) е\емеп{$.а$1154() е\5$е етрфу!15{() 


Используемая здесь функция а5115* - это функция-расширение для Аггау. 
Она возвращает список, содержащий элементы указанного массива. Получен- 
ный в результате список называется неизменяемым, но правильнее считать 
его доступным только для чтения: вы не сможете добавлять или удалять эле- 
менты из него, но если объекты в списке являются изменяемыми, то сам спи- 
сок будет выглядеть доступным для изменения. 


Реализация а$115+ вызывает метод Аггау$ .а$115$+1 в ]ауа, который воз- 
вращает список, доступный только для чтения. 


В этом же пакете присутствуют следующие функции: 


О 11540+; 
О зе%0+; 
О пароф. 


Пример 5.8 иллюстрирует создание списков и множеств. 


Пример 5.8. Создание «неизменяемых» списков, множеств и ассоциативных массивов 


маг пимЕ1${ = 11$%0(3, 1, 4, 1, 5, 9) о 
уаг пимбе{ = зе0{(3, 1, 4, 1, 5, 9) [2] 
// пимбеф.з1те == [3] 


уаг тар = тар0#(1 +0 “опе”, 2 {о “мо”, 3 {о “ЕРгее”) @ 


© Создание неизменяемого списка 

@ Создание неизменяемого множества 

© Множества не хранят повторяющиеся значения 

© Создание ассоциативного массива из экземпляров Ра\г 


х. 
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По умолчанию коллекции в Кот являются «неизменяемыми», то есть 
не поддерживают методов для добавления и удаления элементов. Если сами 
элементы являются экземплярами изменяемого типа, то со стороны такая кол- 
лекция выглядит изменяемой, но сама она будет доступна только для чтения. 

Фабричные методы создания изменяемых коллекций имеют имена, начина- 
ющиеся с приставки «ти{аЫе» (изменяемый): 


О пифаБТе1$40#; 
О пифаЛебефоф; 
О пифаБЛеМаро+. 


Пример 5.9 демонстрирует создание аналогичных изменяемых коллекций. 


Пример 5.9. Создание изменяемых списков, множеств и ассоциативных массивов 


уаг питЕ1${ = пифаБЛе1$40{(3, 1, 4, 1, 5, 9) 
уаг питбе{ = мифаБЛебефо{(3, 1, 4, 1, 5, 9) 
уаг мар = мибаБЛеМароО{Т(1 {о “опе”, 2 +0 “мо”, 3 о “ЕПгее”) 


Вот как выглядит реализация функции паро+ в стандартной библиотеке: 


рус Кип <К, \> мар0{(уагагд ра1гз: Ра1г<К, \>): Мар<К, \/> = 
АЕ (ра1г$.512е > 0) 
ра\г$ . соМар([\пкеФНа$КМар(тарСарас\{у(ра1г$.517е))) 
е15е етрфуМар() 


На входе функция пароР принимает переменный список аргументов с эк- 
земплярами Ра\1г, поэтому для создания элементов ассоциативных массивов 
можно использовать функцию инфиксного оператора +0. Аналогичная функ- 
ция используется для создания изменяемых ассоциативных массивов. 

Также можно создать экземпляры классов, реализующих интерфейсы 115+, 
сер или Мар напрямую, как показано в примере 5.10. 


Пример 5.10. Создание связанного списка 


@Тез+ 
Апфегпа\ Фип `1пзапТа{пд а \АпКед 11$`() { 
уа\ 115 = АпКедЕ1$<Тпф>() 


1154.а99(3) © 
115%.а99(1) 

1151.а94а${(999) о 
115[2] = 4 [2] 


115%. аЧ99АТ (11$ 40+(1, 5, 9, 2, 6, 5)) 
аззегЕТВа{(11$%, сопфа1п$(3, 1, 4, 1, 5, 9, 2, 6, 5)) 


© \Уетод а44 - это псевдоним метода ад9ва$* 
@ При обращении к элементам массивов вызываются методы де* и зе+ 
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5.5. ПоОлучНИЕ ПРЕДСТАВЛЕНИЙ ТОЛЬКО ДЛЯ ЧТЕНИЯ 
ИЗ СУЩЕСТВУЮЩИХ КОЛЛЕКЦИЙ 


Задача 


Из существующего изменяемого списка, множества или ассоциативного мас- 
сива получить его версию, доступную только для чтения. 


Решение 


Создать новую коллекцию, доступную только для чтения, с помощью метода 
фо[1$%, обеф или фоМар. Чтобы представление существующей коллекции было 
доступно только для чтения, его следует присвоить переменной типа (15+, 
бе или Мар. 


Обсуждение 


Рассмотрим изменяемый список, ©0зданный вызовом фабричного метода 
мифа Ле +. Этот список имеет такие методы, как а499, гептоуе и т. д., позволяю- 
щие увеличивать или уменьшать’список по желанию: 


уа1 пибаБеМит$ = пифаБ\е11$40+(3, 1, 4, 1, 5, 9) 


Создать из изменяемого списка версию, доступную только для чтения, мож- 
но двумя способами. Первый - вызвать метод +о15+, возвращающий ссылку 
типа (151: 

@Тез+ 
Рип `$0115& оп мифаБЛеё 15 маКез а геадОп\у пем 11$%`() { 
уа\ геадОп1умит 5: [151<Тп8> = пибаЛеМим$ . 60115%() ® 


аззег{Едуа1.$ (тифаБЛеМит$, геадОп\уМитЕ1${) 
аззег{Мо{бате (тифа \еМит$, геадОп\уМитЕ1${) 


© Явное объявление типа подсказывает, что результат является неизменя- 
емым списком 1[1${<Т> 


Как показывает тест, метод +054 возвращает значение типа 1154<Т>, то 
есть неизменяемый список, в котором отсутствуют такие методы, как а44 или 
гетоуе. Остальная часть теста показывает) что метод создает отдельный объ- 
ект, поэтому, даже притом что он имеет-то же содержимое, что и оригинал, 
эти два списка - разные объекты: 


@Тез+ 

1пеегпа\ Фип `под\Ру пифаБе 115% 4дое$ поф спапде геад-оп1\у 11$%`() { 
уа1 геаФОп1у: [154<Тп{> = мифаБЛеМим$ .{011$1() 
аззег{Едуа1.$(пифаБ\еМим$, геа4Оп\у) 
мибаБДеМит$ .а99(2) 
аззег{ТВа{(геадОп1у, по{(сопфа\п$(2))) 


Если вам потребуется создать представление только для чтения с тем же со- 
держимым, просто присвойте изменяемый список переменной ссылочного 
типа 15%, как показано в примере 5.11. 
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Пример 5.11. Создание представления только для чтения из изменяемого списка 


@Тез+ 

1пеегпа\ Кип `геад-оп\у У1ем о а пифаБе 11$%`() { 
уа1. геадОп1убате[ $: 1154<1п{> = мибаБЛеМит$ ® 
аззег{Едуа1.$ (тифаБ\еМит$, геадОп\убаме!г1${) 
аззег{бате(тифаБ\еМим$, геа4Оп1у5аме! 15) 


мибаБДемит$ .а99(2) 
аззег{Едуа1$ (тифаБ\еМит$, геадОп\убамей 5) 
аззег{бате(тифаБ\еМим$, геа4Оп1у5аме!1${) [2 


Ф Присваивание изменяемого списка переменной ссылочного типа [151 

@ Влдействительности это один и тот же объект 

На этот раз изменяемый список присваивается переменной ссылочного 
типа [1$+. В результате обе переменные не только ссылаются на один и тот же 
список в памяти, но если изменить основной изменяемый список, то пред- 
ставление только для чтения тоже изменится. Вы не сможете изменить список, 
используя ссылку, доступную только для чтения, но она указывает на тот же 
объект, что и исходная переменная. 

Функции 105е{ и +оМар действуют аналогично и для изменяемых множеств 
и ассоциативных массивов возвращают неизменяемые ссылки типа 5е* и Мар. 


5.4. КонстрУИРОВАНИЕ АССОЦИАТИВНОГО МАССИВА 
ИЗ КОЛЛЕКЦИИ 


Задача 


На основе имеющегося списка ключей сконструировать ассоциативный мас- 
сив, связав каждый ключ со значением, сгенерированным программно. 


Решение 


Использовать функцию аззос1акем\Н и лямбда-выражение, которое будет вы- 
звано для каждого ключа. 


Обсуждение 

Пусть имеется набор ключей и каждый из них-требуется связать со сгенери- 
рованным значением. Один из способов сделать Это - использовать функцию 
аз5оста{е, как показано в примере 5.12. 

Пример 5.12. Конструирование ассоциативного массива с помощью а5зос{а{е 


уа1 Кеу$ = ‘а’..’#’ 
уа\ мар = Кеуз.аз5осТафе { 14 о 11. 1054г4п9() .гереа*(5).сар\ка\2те() } 
ргАп Ел (тар) 


Если выполнить этот фрагмент, то он выведет следующий результат: 
{а=Ааааа, Б=ВЬБЬБ, с=Ссссс, 9=09999, е=Еееее} 
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Функция а55осла&е - это встраиваемая (4пИлпе) функция-расширение 
в ЦегаЛе<Т>, которая принимаетлямбда-выражение, преобразующее Тв Ра1г<К, 
\>. В этом примере используется инфиксная функция +о, которая создает Ра\г 
из левого и правого аргументов. 

В версии Ко т 1.5 появилась новая функция а$зос1афеА В, которая по- 
могает сделать код еще проще. В примере 5.13 показано, как будет вы- 
глядеть код из предыдущего примера, если вместо а$$осла{е использовать 
аззос1ажема ев. 


Пример 5.13. Конструирование ассоциативного массива с помощью а5зос!а{е\ М/И 


уа1 Кеу$ = ‘а’..’Е” 
уа\ мар = Кеуз. аззослафемоВ { 1+. +05%г4пд().гереа*(5).сар\ фа те() } 
рглп л (тар) 


Результат тот же самый, но Теперь в аргументе передается функция, генери- 
рующая значение 5+г\пд, а не Ра1<СВаг, 54г1пд>. 

Оба примера создают один от же результат, но применение функции а5- 
5остафем (В выглядит проще. 


5.5. ВОЗВРАТ ЗНАЧЕНИЯ ПО УМОЛЧАНИЮ 
В СЛУЧАЕ ПУСТОЙ КОЛЛЕКЦИИ 


Задача 


При обработке коллекции были отфильтрованы все ее элементы, и требуется 
вернуть ответ по умолчанию. 


Решение 


Использовать функции \{Ептр\у и \ЕВТапк, если коллекция или строка окажется 
пустой. 


Обсуждение 


Пусть имеется класс данных Ргодис* со строковым свойством паме, числовым 
СВОЙСТВОМ рг4се и логическим свойством опба\е, указывающим, имеется ли 
в продаже данный продукт, как показано в примере 5.14. 


Пример 5.14. Класс данных, представляющий продукт 


Чафа с\а$$ РгодисЕ(ма\ паме: $%г\пд, 
уаг рг4се: БоиЛе, 
уаг опба\е: Воо{еап = Фа\$е) 


Чтобы вывести список продуктов, имеющихся в продаже, можно выполнить 
простую операцию фильтрации, как показано ниже: 


Рип паме$0Ргодисе$Опба\1е(ргодисе$: 11${<Ргодис*>) = 
ргодисе$. РА 4ег { 1{.опба\е } 
.мар { 1*.пате } 
. ]олпТоЗЕг1п9(зерагафог =“, “) 


х. 
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Этот код получает список продуктов, фильтрует его по логическому свой- 
ству опба1е и оставляет только их названия, которые затем объединяются 
в одну строку. Проблема в том, что если в продаже нет ни одного товара из 
списка, фильтр вернет пустую коллекцию, которая затем будет преобразова- 
на в пустую строку. 

Если для пустого результата требуется вернуть конкретную строку, можно 
использовать функцию \1Епрйу, имеющуюся в классах СоДес оп и 5&г\лд. При- 
мер 5.15 показывает, как это сделать. 


Пример 5.15. Использование метода НЕтр\иу классов СоЦесНоп и 5/тд 


Рип опба\еРгодис*$_1РЕмреуСо Дес \1оп(ргодисЕ$: [15<Ргодис{>) = 
ргодисе$. РАД ег { 1.опбае } 
.мар { 1*.пате } 
.АЕЕтреу { 11540 (“попе”) } о 
. ]олпТоЗЕг1п9(зерагафог =", ") 


Рип опба\еРгодисЕ$_1РЕмреу5г1па(ргодисЕ$: 115%<Ргодис*>) = 
ргодисе$. РАД ег { \{.опбае } 
„мар { 1*.пате } 
. ]олпТо5Ег1п9(зерагафог =“, “) 
‚АЕЕтреу { “попе” [2] 


о Подставляет значение по умолчанию для пустой коллекции 
9 Подставляет значение по умолчанию для пустой строки 


В обоих случаях, если в коллекции нет ни одного продукта, имеющегося 
в продаже, код вернет строку «попе», как показывают тесты в примере 5.16. 


Пример 5.16. Тестирование продуктов 


СТа$$ ТРЕмру0гВ\апККЕТез{ { 
рг\\ае уа1 омегЕВги${ег = Ргодисе(“О$с Ла оп ОуегЕВгиз{ег”, 1_000 000.0) 
рг\\афе уа1 Е\ихсарас\Фог = Ргодис*(“Р\их Сарас\ог”, 299_999.95, опба\е = «гие) 
рг\уаЕе уа\ ЕрзВерог(Сомуег5НееЕе = РгодисЕ(“ТР5 ВерогЕ Сомуег 5Неет”, 0.25) 


@Те$& 
Рип ргодис$Опба\е() { 
уа\ ргодисЕ$ = 115401 (оуегЕВгиз%ег, Г\ихсарас\Жог, рзВерог{Соуег5Неет) 


аззегЕА( “Оп за\е ргодис*$”, 
{ аззегЕЕаца1$(“Е\их Сарас\%ог”, 
опба\еРгодис&$_1РЕтреуСоДес\оп(ргодис{$)) }, 
{ аззегЕЕаца1$(“Е\их Сарас\%ог”, 
опба\еРгодис&$_1РЕтреу$г4пд(ргодист$)) }) 


} 


@Те$+ 
Рип ргодисЕ$М№*0Опба\е() { 
уа\ ргодисЕ$ = 115101 (омегВгизёг, `Ер$ВерогЕСомег5вее{) 


аззегЕАЩ( “№  ргодисе$ оп за\е”, 
{ аззегЕЕаца\$(“попе”, опба\еРгодис&$_1РЕтреуСоДес\оп(ргодис{$)) }, 
{ аззегЕЕаца1$(“попе”, опба\еРгодис&$_1РЕтреу${г4пд(ргодист$)) }) 
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В ]ауа 8 появился новый класс Ор\опа1<Т>, который часто используется как 
обертка для возвращаемого типа, если запрос может вернуть пустое значение 
или значение пи\1. Ко шп тоже поддерживает этот тип, но в большинстве слу- 
чаев проще вернуть конкретное значение с помощью функции \ЧЕпрфу. 


5.6. ОГРАНИЧЕНИЕ ЗНАЧЕНИЙ ЗАДАННЫМ ДИАПАЗОНОМ 


Задача 


Для заданного значения вернуть его, если значение попадает в определенный диа- 
пазон, или значение нижней или верхней границы диапазона в противном случае. 


Решение 


Использовать функцию соегсеТп и передать ей диапазон или минимальную 
и максимальную границы. 


Обсуждение 


Имеется две перегруженные версии функции соегсе1п: одна принимает закры- 
тый диапазон, а вторая - минимальное и максимальное значения. 

Рассмотрим применение первой версии с диапазоном целых чисел от 3 до 8 
включительно. Тест в примере 5.17 показывает, что возвращает соегсеТп, если 
значение попадает и не попадает в указанный диапазон. 


Пример 5.17. Приведение значения к диапазону 


@Тез+ 
Рип `соегсеТп д1\еп а гапде`() { 
уа\ гапде = 3..8 


аззег{ТВа{(5, `1$`(5.соегсеТп(гапде))) 
аззег(ТВа{(гапде.зфаге, `1$`(1.соегсеТп(гапде))) 0 
аззег{ТРа*(гапде.еп9дТпс\и$Аме, `1$5`(9.соегсеТп(гапде))) @ 


© Свойство гапде. з+аг{ равно 3 
@ Свойство гапде .еп9Тпс\из\уе равно 8 
Точно так же, если известны минимальное и максимальное значения, 


не нужно создавать диапазон для использования функции соегсеТп, как пока- 
зано в примере 5.18. 


Пример 5.18. Приведение значения к диапазону при известных минимальном и максималь- 
ном значениях 


@Тез+ 

Рип `соегсеТп 91\еп Ап ап мах`() { 
уа\ пп = 2 
уа\ мах = 6 


аззег{ТВа{(5, `1$`(5.соегсеТп(пИп, мах))) 
аззегЕТВа{(мАп, `1$`(1.соепсеТй(гАп, тах))) 
аззегЕТВа{(мах, `1$`(9.соегсеТп(гАп, мах))) 


х. 
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Эта версия вернет само значение, если оно находится между минимальным 
и максимальным значениями, или граничное значение в противном случае. 


5.7. ОБРАБОТКА КОЛЛЕКЦИЙ МЕТОДОМ СКОЛЬЗЯЩЕГО ОКНА 


Задача 
Обработать коллекцию значений методом скользящего окна. 


Решение 


Использовать функцию спипКед, если требуется разделить коллекцию на рав- 
ные части, или функцию \пдомед, чтобы получить окно, скользящее вдоль кол- 
лекции с заданным шагом. 


Обсуждение 


Функция свипКед принимает любую итерируемую коллекцию и разбивает ее на 
список списков с размерами, равными или меньше заданного. Функция имеет 
две перегруженные версии, одна просто возвращает список списков, а вторая 
принимает преобразование для применения к получившимся спискам. Сигна- 
туры обеих версий функции приводятся ниже: 


Рип <Т> ЦегаБЛе<Т>.спипКед($17е: Тпе): 1154<[154<Т>> 


Рип <Т, В> ГегаЛе<Т>. свипКед( 
$126: Тпф, 
{гап$Фогт: (115$4<Т>) -> В 
): [151<В> 


Ситуация выглядит сложнее, чем есть на самом деле. Например, рассмотрим 
диапазон целых чисел от 0 до 10. Тест в примере 5.19 разбивает его на группы 
по три числа в каждой и вычисляет суммы и средние значения в группах. 


Пример 5.19. Деление списка на фрагменты и последующая их обработка 


@ТезЕ 
1п{егпа1 Фип спипКед() { 
уа1 гапде = 0..10 


уа1 спипКед = гапде.сКипКед (3) 
аззег{ТВа{(сВипКед, соп{а1п$(11$5101(0, 1, 2), 1154073, 4, 5), 
115401 (6, 7, 8), 11$401(9, 10))) 


аззег{ТВа{ (гапде.спипКе(3) { 1.5ит() }, `1$`(1А540Е(3, 12, 21, 19))) 
аззег{ТВа{(гапде.спипКед(3) { 1*.а\егаде() }, `1$`(11$401(1.0, 4.0, 7.0, 9.5))) 


Первый вызов просто возвращает список 11${<[1${<Тп{>>, состоящий из ПОД- 
списков: [[0, 1, 2], [3, 4, 5], [6, 7, 81, [9, 10]]. Во второй и третий вызовы 
передаются лямбда-выражения, вычисляющие сумму и среднее значение для 
каждого подсписка соответственно. 

Функция спипкед фактически является частным случаем функции и лпдомед. 
Пример 5.20 демонстрирует, как спипКед делегирует работу функции и\пдомеч. 


100 *% Коллекции 


Пример 5.20. Реализация функции спипкКе4 в стандартной библиотеке 


руб\Ас Кип <Т> ГегаЛе<Т>.сКипКед($17е: Тпё): 11$4<[4154<Т>> { 
гефигп и\пдоие9($17е, $17е, раг{\а\И\Апдом$ = гие) 


} 


Функция и\п4доме4 принимает три аргумента, два из которых являются не- 
обязательными: 


$17е 
количество элементов в каждом окне; 


зфер 


на сколько элементов вперед должно перемещаться окно на каждом шаге 
(по умолчанию 1); 


раг\аЦ\Апдом$ 


логический флаг со значением по умолчанию [а15е. Сообщает, необходимо 
ли сохранить последний фрагмент, если он содержит меньше элементов, чем 
задано параметром $17е. 


Функция свипКед вызывает и\пдомед и передает ей в параметрах $17е и з{ер 
значение своего аргумента, поэтому на каждом шаге окно смещается точ- 
но на его размер. Однако если потребуется обработать коллекцию методом 
скользящего окна с другим шагом, можно использовать и1пдомед напрямую. 

Для иллюстрации рассмотрим вычисление скользящего среднего. В приме- 
ре 5.21 показано, как от функции и\пдомед добиться поведения свипКед и как на 
каждом шаге передвигать окно только на один элемент. 


Пример 5.21. Вычисление скользящего среднего в каждом окне 


@ТезЕ 
Рип и1пдоиед() { 
уа\ гапде = 0..10 


аззегТВа{(гапде.мАпдоиед (3, 3), 
сопфа1п$ (11$401(0, 1, 2), 11$401(3, 4, 5), 1А$%0Е(6, Т, 8))) 


аззег{ТВа{(гапде.иАпдомед (3, 3-4 1*.а\уегаде() }, 
сопфа1п$(1.0, 4.0, 7.0)) 


аззег{ТВа{(гапде.иАп4домед(3, 1), 
сопфа\п$( 
115401(0, 1, 2), 11540Е(1, 2, 3), 11$401(2, 3, 4), 
115401(3, 4, 5), 115401(4, 5, 6), 11$401(5, 6, 7), 
115401 (6, 7, 8), \15%ОЕ(Т, 8, 9), 11540Е(8, 9, 10))) 


аззег{ТВа{(гапде.иАпдомед (3, 1) { 1*.а\егаде() }, 
сопфа1п$(1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.50, 9.0) 


Функции свипКеф и иАпдоиед — удобные инструменты для поэтапной обработ- 
ки временных последовательностей. 
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5.8. ДЕСТРУКТУРИЗАЦИЯ СПИСКОВ 


Задача 
Использовать механизм деструктуризации ДлЯ доступа к элементам списка. 


Решение 
Присвоить список группе, содержащей до пяти элементов. 


Обсуждение 


Деструктуризация - это процесс извлечения значений из объекта путем при- 
сваивания их коллекции переменных. 

Пример 5.22 демонстрирует, как присвоить первые пять элементов списка 
пяти переменным за один шаг. 


Пример 5.22. Деструктуризация элементов списка 
май 1456 = ИЗЕ(“а”, “5”, “с”, “4”, че”, “Е”, «д”) 
уа1 (а, Б, с, 4, е) = 115% 

ргАп п ( "ба $6 $с $4 $е”) 


Этот код выведет строку а Ь с 4 е, потому что первые пять элементов соз- 
данного списка будут записаны в пять переменных. Деструктуризация под- 
держивается функциями-расширениями для класса 115%, реализованными 
в стандартной библиотеке с именами сотропеп*М, где № - число от 1 до 5, как 
показано в примере 5.23; 


Пример 5.23. Функция-расширение сотропеп{1 для класса 145+ (из стандартной библиотеки) 


ты 
* Возвращает 1-й *элемент* коллекции. 
т 
@Ко Ап .АпЕегпа\.. ТП лпебп1у 
рус 1пАпе орегафог Фип <Т> 115{<Т>.сотропеп*1(): Т { 
гефигп 9е*(0) 
} 


Деструктуризация зависит от функций сопропеп* М. Класс 1151 содержит функ- 
ции сопропепт1, сотропеп{2, сотропеп{3, сотропеп{4 и сомропепф5, поэтому предыду- 
щий код работает. 

Классы данных автоматически добавляют методы сопропеп\№ для всех сво- 
их атрибутов. Если вы определите свой класс (но не объявите его классом 
данных), то сможете вручную добавить все необходимые методы сотропеп* М. 

Деструктуризация дает удобную возможность извлечь из объекта сразу не- 
сколько элементов. В настоящее время класс 1151 определяет функции сопро- 
пепЕ№ только для первых пяти элементов, но в будущих версиях Кот ситуация 
может измениться. 
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5.9. СортИРОВКА ПО НЕСКОЛЬКИМ СВОЙСТВАМ 


Задача 


Отсортировать список экземпляров класса по одному свойству, затем по вто- 
рому ит. д. 


Решение 
Использовать функции зог%еди\{Н и сопрагеВу. 


Обсуждение 


Пусть имеется простой класс данных бо\Фег и коллекция его экземпляров, как 
показано в примере 5.24. 


Пример 5.24. Класс данных и коллекция его экземпляров 


Дафа с1а$$ бо1Рег(уа\ хсоге: Тпе, ма\ Р4г${: 5%г1пдл ма Таз: 5%г1пд) 


уа\ д9о\Фег$ = 11$401( 
Со1Рег(70, “Заск”, “МсКТаи$”), 
Со1Рег(68, “Том”, “Мафзоп”), 
Со1Рег(68, “ВиББа”, “Мазоп”), 
Со1Рег(70, “Т1дег”, “Моод$”), 
Со1Рег(68, “Ту”, “мебЬ”) 


Чтобы отсортировать этот список игроков в гольф сначала по количеству на- 
бранных очков, затем по фамилии и наконец по имени, можно использовать 
код, показанный в примере 5.25. 


Пример 5.25. Сортировка списка игроков в гольф по нескольким свойствам 


уа1 зог{еф = до\Рег$ . зогфеди\ЕН( 
сотрагеВу({ 1.зсоге }, { 1+.1аз% }, { 14. г) 
) 


зог%е4.РогЕасй { рглпп(14) } 


Этот код выведет следующий результат: 


Со\Рег(зсоге=68, РАгз%=ВибБа, 1а$%=Мае$оп) 
Со\Рег(зсоге=68, РАгз%=Тот, 1а${=Ма%$оп) 
бо\Фег(зсоге=68, РАг${=Ту, Таз%=МеБь) 
Со\Рег(зсоге=70, РАгз%=ЭасК, 1а5{=МсК\Таи$) 
бо\Фег(зсоге=70, РАг${=ТАдег, \а${=Ио04$) 


Трое игроков, набравших по 68 очков, выводятся раньше игроков, набрав- 
ших по 70 очков. В группе с игроками, набравшими по 68 очков, первыми вы- 
водятся игроки с фамилией У!а{5оп, а затем УМ/еЪЪ. В группе с игроками, на- 
бравшими по 70 очков, первым выводится игрок с фамилией №1сКаиз, а затем 
М'оод$. Из игроков с фамилией М’а!зоп, набравших по 68 очков, первым выво- 
дится игрок с именем Виа, а затем Тот. 

Полные сигнатуры функций зогЕеди{Н и сопрагеВу показаны в примере 5.76. 


х. 
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Пример 5.26. Сигнатуры функций зоцеа\М/ИВ и сотрагеВу из стандартной библиотеки 


Рип <Т> ЦегаБЛе<Т>. огфедиА В ( 
сотрагафог: Сомрагафог<Ап Т> 
): 1 $Е+Т> 


ип <Т> сомрагеВу( 
уагагд °е\есфогз: (Т) -> СотрагаЛе<*>? 
): Сотрагафог<Т> 


То есть функция зогееди В принимает экземпляр Сопрага®ог, а функция соп- 
рагеВу возвращает экземпляр Сопрагатог. Интересно отметить, что функции соп- 
рагеВу можно передать список селекторов, каждый из которых извлекает свой- 
ство Сотрагае (обратите внимание, что тип свойства должен реализовать 
интерфейс СопрагаЛе), а функция создаст экземпляр Сопрагафог, сортирующий 
их по порядку. 

Функции зог*Ву и зогЕИ\ЕН сортируют свои элементы на месте и по- 
этому могут применяться только к изменяемым коллекциям. 


Ту же задачу можно решить иным способом: создать экземпляр Сотрагафог 
с помощью последовательности вызовов функции *ПепВу, а затем использовать 
его для сортировки коллекции, как показано в примере 5.27. 
Пример 5.27. Объединение нескольких компараторов 


уа1 сотрагафог = сотрагеВу<бо\ег>(бо\Фег: :$соге) 
. СВепВу(бо\Рег: :1а$%) 
. СВепВу(бо\ег: : 4Аг$) 


до\Рег$ . зогЕеди\.ЕН (сотрагафоп) 
„РогЕасй( : : рглп п) 


Этот код вернет тот же результат, что и предыдущий пример. 


5.10. ОПРЕДЕЛЕНИЕ СВОЕГО ИТЕРАТОРА 


Задача 


В собственном классе, обертывающем коллекцию, реализовать перебор ее эле- 
ментов. 


Решение 


Определить функцию-оператор, возвращающую итератор с методами пехЕ 
и Ваз№ хе. 


Обсуждение 


Шаблон проектирования «Итератор» (Цега{ог) реализуется в ]ауа с помощью 
интерфейса Т*егафог. В примере 5.28 показано соответствующее определение 
в Кот. 
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Пример 5.28. Интерфейс Иега{ог в Ко{Ип.соЦесНоп$ 


1пеегРасе Т%егафог<ои* Т> { 
орегафог Фип пехЕ(): Т 
орегафог Фип Раз№е ех*(): Воо\еап 


В ]ауа обход элементов класса, реализующего/интерфейс Г{егаЛе, можно 
реализовать с помощью цикла Ююг-еасВ. В Ко т'для этой цели использует- 
ся цикл Юг-т. Рассмотрим класс данных Р\ауег и класс Теат, представленные 
в примере 5.29. 


Пример 5.29. Классы Р(ауег и Теат 


Чафа с\а$$ Р1ауег(ма\ паме: $4г1пд) 
СТа$$ Теам(\уа1 паме: 5+гАпд, 
уа1 р1ауегз: МифаБЛе1${<Р\ауег> = мифа \е11$401()) { 


Рип ад9РТауег$(уагагд реор\е: Р\ауег) = 
р\ауег$ .а9 ЧАТ (реор1е) 


// ... другие функции... 


Класс Теат содержит изменяемый список экземпляров Р\ауег. Чтобы выпол- 
нить обход всех игроков в команде, необходимо обратиться к свойству р1ауегз, 
как показано в примере 5.30. 


Пример 5.30. Обход игроков в команде 


уа1 {еам = Теам(“Магг\1ог$”) 
{еам. а9ЧР1ауег$(Р1ауег(«Сиггу»), Р1ауег («ТВотрзоп»), 
Р1Тауег(«Бигап»), Р1ауег(«Сгееп»), Р1ауег(«Соц$1п$»)) 


Фог (р\ауег &п {еам.р1ауегз) { ® 
ргАп 1п(р\Тауег) 
} 


© Доступ к свойству р\Тауег$ в цикле 


Эту задачу можно упростить, если в классе Теап определить функцию-опе- 
ратор с именем егафог. В примере 5.31 показано, как определитьтакую функ- 
цию в виде функции-расширения и насколько проще выглядит цикл. 

Пример 5.31. Обход игроков в команде без обращения к свойству р{ауег$ 
орегафог Фип Теат.1{егафог() : Т%егафог<Р1ауег> = р\ауег$.1\егафог() 


Фог (р\ауег 4п {еам) { ® 
ргАп1п(рТауег) 
} 


© Итерации выполняются непосредственно по экземпляру команды, без 
обращения к свойству р\ауег5 


Оба последних примера выведут один и тот же результат: 


х. 
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Р1ауег (пате=Сиггу) 
Р\ауег(пате=ТВомр$оп) 
Р\ауег(пате=Бигап®) 
Р1ауег (пате=Сгееп) 
Р1ауег (пате=Соц$1п$) 


На самом деле идея состоит в том, чтобы реализовать в классе Теам интер- 
фейс ГегаБЛе, что подразумевает реализацию функции-оператора \егахог. 
'То есть вместо добавления функции-расширения можно изменить определе- 
ние класса Теам, как показано в примере 5.32. 

Пример 5.32. Реализация интерфейса №егаЩе 
СТа$$ Теам(\уа\ паме: 5{г4лпд, 
уа1 р1ауег$: Мифае1${<Р\ауег> = мифа \е11$401()) : ГегаЛе<РТауег> { 


о\уегг14де Рип 1{егафог(): Ткегафог<РТауег> = 
р\ауег$.\{егафог() 


// ... другие функции... 


Результат получится тот же, только теперь в классе Теам будут доступны все 
функции-расширения для [КегаЛе и появится возможность писать код, пока- 
занный в примере 5.35. 

Пример 5.33. Использование функций-расширений МегаЦе в Теат 


а$зег{Едиа1.$(«Соц$1п$, Сиггу, Вигапёу Сгееп, ТВомр$оп», 
{еам.мар { 1*.паме }.)опТо571п9()) 


Здесь функция пар перебирает игроков, поэтому 1*.паме представляет имя 
каждого игрока. Аналогично можно использовать другие функции-расши- 
рения. 


5.11. ФильтрдЦИЯ ЭЛЕМЕНТОВ КОЛЛЕКЦИЙ ПО ТИПАМ 


Задача 


На основе имеющейся коллекции, включающей элементы разных типов, соз- 
дать новую коллекцию, содержащую только элементы определенного типа. 


Решение 
Использовать функцию-расширение Е \{егТ5Тпзапсе или Г егТ$Тпз{апсеТо. 


Обсуждение 


Коллекции в Кот включают функцию-расшгирение 1 \ег, которая принимает 
предикат для извлечения элементов, удовлетворяющих любому логическому 
условию, как показано в примере 5.34. 
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Пример 5.34. Фильтрация элементов коллекции по типу со стиранием типа 


уа\. 1154 = 115401(“а”, 1оса\а*е.пом(), 3, 1, 4, “Б”) 
уа\ $1г1пд$ = 115%.РАег { 14 15 5г4мд } 


Ког ($ 1п $Ег1пд$) { 
// $.1епаЕВ // не компилируется; тип стирается 
} 


Операция фильтрации прекрасно работает в этом примере, но тип перемен- 
ной 51г1пд$ определяется как 1 $*<Апу>, поэтому Ко т не выполняет интеллек- 
туального приведения отдельных элементов ктипу 5+г1пд. 

При необходимости можно добавить проверку 1$ или просто использовать 
функцию РегТ$Тпз*апсе, как в примере 5.35. 


Пример 5.55. Овеществление типов 


уа\. 1154 = 11540#(“а”, 1оса\а*е.пом(), 3, 1, 4» “Б”) 


уа1 аЦ. = 115+. Е егТ$Тп${апсе<Апу>() 

уа1. ${г1п9$ = 115%. РА Цег1$Тп5апсе<5{г1пд>() 

уа1 11$ = 115%.РАег1$Тп$апсе<Тп{>() 

уа1 Чдафе$ = 115%.РЛег1$Тп$апсе([оса\а{е: :с1а$$. ]ама) 


аззегЕТВа{(а\1, `1$`(11$%)) 

аззег{(ТВа{($г1п9$, сопфа\пзТпАпу0г4ег(“а”, “Б”)) 
аззег{ТВа{(1п{$, сопфа1п$ТпАпу0г4ег(1, 3, 4)) 
аззегЕТВа{(Чафе$, сопфеа1п$ (1оса\а*е.пои())) 


Функция Е ЦегТ$Тпз{апсе использует механизм овеществления типа, поэто- 
му получающиеся коллекции имеют известный тип и не нужно проверять тип 
их элементов перед использованием. Вот как реализована функция Е {ег1Т$Тп- 
зфапсе в библиотеке: 


руБАс пе Фип <ге\РАед В> Г4егаБЛе<*>. Е {егТ$Тп$апсе (т 11 5<В> { 
гефигп Е{егТ$Тп{апсеТо(Аггау11$+<В>()) 
} 


Ключевое слово ге\ЁРед сохраняет тип, поэтому возвращаемое значение 
имеет тип [1$1<В>. 

Реализация вызывает функцию Е{егТ$ТпзапсеТо, которая принимает коллек- 
цию определенного типа и заполняет ее элементами этого типа из оригинала. 
Эту функцию также можно использовать напрямую, как показано в примере 5.56. 


Пример 5.36. Использование овеществления типов для заполнения заданного списка 


уа\. 1154 = 11540#(“а”, 1оса\а*е.пом(), 3, 1, 4, “Б”) 


уа\ а = 115%. РА ег1Т$Тп${апсеТо (тифа \е11$401()) 

уа\ $1г1пд$ = 115%. Р{егТ$ТпзапсеТо (мифа Ле! 1${0+<5г4п9>()) 
уа1 114$ = 115%. РА егТ$Тп${апсеТо( тифа \е11$40+<Тп*>()) 

уа\ Фафе$ = 115%. Р\ег1$Тп${апсеТо (мифа Ле! 1${0+<[оса\Ва{е>()) 


аззегЕТВа{(а\1, `1$`(11$%)) 

аззег(ТВа{($%г1п9$, сопфа\пзТпАпу0г4ег(“а”, “Б”)) 
аззег(ТВа{(1п{$, сопфа1п$ТпАпу0г4ег(1, 3, 4)) 
аззегЕТВа{(Чафе$, сопфа1п$ (1оса\а*е.пои())) 


. 
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Аргумент функции Е \ег1Т$Тп{апсеТо имеет тип МифаДеСоДеслоп<1п В>, ПО- 
этому достаточно указатв»желаемый тип коллекции, чтобы заполнить ее эк- 
земплярами этого типа. 


5.12. ПРЕОБРАЗОВАНИЕ ДИАПАЗОНА В ПРОГРЕССИЮ 


Задача 


Выполнить обход диапазона, который не является диапазоном простых целых 
чисел или символов. 


Решение 
Создать прогрессию. 


Обсуждение 


В Кош диапазон создается оператором двойной точки (..). Например, вы- 
ражение 1..5 создаст экземпляр ТпВапде. Диапазон - это закрытый интервал, 
определяемый двумя конечными точками, входящими в диапазон. 

Стандартная библиотека добавляет функцию-расширение гапдеТо к любому 
обобщенному типу Т, который реализует интерфейс СопрагаЛе. В примере 5.37 
показана ее реализация. 


Пример 5.37. Реализация функции гапдеТо для типов СотрагаЩе 


орегафог Фип <Т : Сотрага\е<Т>> Т.гапдеТо({Ва*: Т): С1озедВапде<Т> = 
СотрагаЛеКапде(+В\$, {Ва{) 


Класс СотрагаЛеВапде просто расширяет СоптрагаЛТе, определяет свойства $+аг* 
и епдТпс\и51уе типа Т и переопределяет. функции едца\5, ВазНСоде и +о5%г4пд. Зна- 
чение, возвращаемое функцией гапдеТозимеет тип СТозедВапде — простой интер- 
фейс, определение которого показано в примере 5.38. 


Пример 5.38. Интерфейс С(1о5е49Вапде 


1пфегРасе СТозеФВапде<Т: Сотрагае<Т>> { 
уа\ эфаге: Т 
уа\ епдТпс\и$4уе: Т 
орегафог Фип сопфа\п$(уа\ие: Т): Воб1еап = 
уа\ие >= ${аге && уа\ше <= епдТпс\и$1уе 
Рип 15Емрфу(): Воо\еап = $Фаге > епдТпс\и$1ме 


Функция-оператор сопеа1пз позволяет использовать инфиксную функцию \1п 
для проверки попадания некоторого значения в диапазон. 

Из всего этого следует, что диапазон можно создать на основе любого клас- 
са, реализующего Сопрагаве, а вся инфраструктура, необходимая для его под- 
держки, уже существует. Для иллюстрации возьмем тип да\а. ме. Госа\а{е 
(см. пример 5.39). 
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Пример 5.39. Использование ГосаШа{е в диапазоне 


@Тез+ 

Рип `[оса\ае 1п а гапде`() { 
уа1 °{аг{Бафе = [оса\а&е.пом() 
уа\ п19бафе = ${агЕОа\фе.р1и$Оау$(3) 
уа1 епдбафе = ${агЕОа\фе.р1и$Оау$(5) 


уа1 ЧафеВапде = зфаг{Оа{е. .епдОафе 


аззег%А ( 
{ аззегЕТгие( {аг{Оа{е 1п дафеКапде) }, 
{ аззегЕТгие(т\ЧОае 1п дафеКапде) }, 
{ аззегЕТгие(еп9Оае 1п дафеКапде) }, 
{ аззегЕТгие(${аг{Оафе.т\пи$Вау$(1) !1п” ЧатеВапде) }, 
{ аззегЕТгие(еп@Оа{е.р1и$Вау$(1) !4п ЧафеВапде) } 


Вроде бы все хорошо, но при попытке выполнить обход диапазона начинают 
твориться странности: 


Фог (Фафе 1п Чафевапде) ргАп п (14) [/ ошибка компиляции! 
(загЕОафе. .еп4Оате).КогЕасН { /*... */ } // ошибка компиляции! 


Проблема в том, что диапазон не является прогрессией. Прогрессия - это 
всего лишь упорядоченная последовательность значений. Пользовательские 
прогрессии реализуют интерфейс ГегаБе, как и готовые прогрессии ТпЕРго- 
дге$$1оп, [опдРгодгез1оп и СпагРгодге$$1оп в стандартной библиотеке. 

Рассмотрим создание прогрессий на примере классов в примерах 5.40 и 5.41. 


Код этого примера основан на статье Гжегожа Зимонски (Сг2езог7 
Ллетой$К1) «УРаЕ Аге Кот Ргоэтез$10п$ апа МУТу 5воша Уои Саге?» 
в топе (6 рз://огей Лу/-Мад\МУ). 


Первый класс - Госа\БажеРгодге$\оп — реализует интерфейсы Т%егаЛе<!оса\Ба{е> 
и СТозеЧВапде<Ёоса\Ва*е>. 


Пример 5.40. Прогрессия для ГосаРае 
1трогЕ )а\а. {1те.[оса\Ва{е 
СТаз$ [оса\Ба%еРгодге$$\1оп( 
о\уегг14е уа\ з+аг{: 1оса\Ба*фе, 
о\уегг14е уа1 епдТпс1и$1уе: 1оса\а*е, 


уа\ °{ер: 1опд = 1 
) : ЦегаЛе<Госа\а&е>, С1озедВапде<!оса\Ва*е> { 


о\уегг14де Рип 1{егафог(): Т%егафог<[оса\Ва*е> = 
[оса\ОафеРгодге$<1опТ«егафог(${фагЕ, епдТпс\и$1уе, {ер) 


1пРАХ Рип зер(дау$: 1опд) = [оса\Ба%{еРгодгез$1оп(${аг{, еп9Тпс\и$1уе, дауз) 


х. 
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Из интерфейса Т*егафог достаточно реализовать единственную функцию 
\{егафог. В данном случае она создает экземпляр класса 1оса\Ба{еРгодгез- 
злопТ{егафког, определение которого показано ниже. Инфиксная функция 
фер создает экземпляр класса, который правильно выполняет прираще- 
ние в днях. Интерфейс С1озеЧВапде, как показано в примере 5.40, определяет 
свойства заг* и епдТпс\и$1уе, поэтому здесь они переопределяются в основ- 
ном конструкторе. 


Пример 5.41. Итератор для класса 1осааеРгодге оп 


1троге )а\а. 1те.[оса\Оа%е 


1п{егпа1 с1а$$ 1оса\ОаферРгодге$ТопТ%егафог( 
<фаг&: [оса\а*е, 
уа\ еп9Тпс1и$1\е: 1оса\а*е, 
уа1 ${ер: 10пд 

) : Цегафог<Госа\а*е> { 


рг\\афе маг сиггепЕ = з%аг* 
оуегг14де Рип Баз№ехе() = сиггепе <= епдТпс1и$1ме 


оуегг\4е Кип пехЕ(): [оса\Ба{е { 
уа\ пехЕ = сиггепе 
сиггепе = сиггепе.р1и$Даус ( ${ер) 
гефигп пехе 


Интерфейс Гегафог требует переопределить методы пех* и Ваз№ х{, как по- 
казано здесь. 

Наконец, определим функцию-расширение гапдеТо, возвращающую экземп- 
ляр прогрессии: 


орегафог Фип 1оса\а*е.гапдеТо(о%Вег: [оса\Ба*е) = 
[оса\ФафеРгодге$$1оп (В $, отВег) 


Теперь Госа\Фа{е можно использовать для создания диапазона, поддержива- 
ющего возможность итераций, как показано в примере 5.42. 


Пример 5.42. Тесты для прогрессии Госа.ае 


@Тез& 

Рип `исе 1оса\афе аз а ргодгез$1оп`() { 
уа1 °{аг{Бафе = [оса\а&е.пом() 
уа\ епдРафе = {аг{Оа\е.р\и$Вауз(5) 


уа\ дафевапде = зфагЕБа{фе. .еп9Оаке 

ЧафеВапде.КогЕасНТпдехед { 1пдех, 1оса\Оа{е -> 
аззегЕЕдца1$(Тоса\Бафе, $фаг{Оа*е.р\и$Бауз (1пдех. 01опд())) 

} 


уа\ дате! 1${ = дафевапде.мар { 1%. Ко5г\1п9() } 
аззег{Едиа1$(6, ЧафеЁ15{.517е) 
} 
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@Тез+ 

Рип `изе [оса\Оафе аз а ргодгез$1оп мАЕН а з%ер`() { 
уа1 °{аг{Бафе = [оса\а&е.пом() 
уа1 епдбафе = <{агЕОа\фе.р\и$Оау$(5) 


уа1 Чафевапде = зфаг{Оа{е. .епдОафе °{ер 2 

ЧафеВапде.КогЕасНТпдехе4 { 1пдех, 1оса\а{е -> 
аззегЕЕдиа1$(Тоса\Оафе, ${аг{а%е.р1и$Бау$ (Апдех. коЁопд() * 2)) 

} 


уа\ дате! 1${ = дафевапде.мар { 14. Ко5г\1п9() } 
аззег{Едуа1$(3, дафе11${.$17е) 


Оператор двойной точки (..) создает диапазон, который в этом случае под- 
держивает возможность итераций, используемую функцией ФогЕасйТпдехед. 
Для создания прогрессии.в данном примере потребовалось определить два 
класса и функцию-распгирение, но этот шаблон достаточно легко воспроизвес- 
ти для любого из собственных классов. 


Глава 


Последовательности 


В этой главе рассматриваются последовательности Ко 11, которые очень по- 
хожи на потоки данных, добавленные в ]ауа 1.8. Это сравнение полезно, только 
если вы уже знаете, как работают потоки в ]ауа7. Рецепты в данной главе под- 
черкивают их сходства и различия. 

Коллекции обрабатываются жадно, то есть целиком и сразу: когда вызывает- 
ся метод пар или Рег коллекции, он обрабатывает все элементы коллекции. 
Последовательности, напротив, обрабатываются лениво: при обработке после- 
довательности каждый ее элемент проходит весь конвейер от начала до конца, 
прежде чем будет обработан следующий элемент. Это помогает обрабатывать 
большие объемы данных и выполнять такие операции, как Е Агз*, которые пре- 
кращают обработку, встретив первое желаемое значение. 


6.1. Использование леНИВЫХ ПОСЛЕДОВАТЕЛЬНОСТЕЙ 


Задача 


Обработать минимальный объем данных, необходимый для выполнения опре- 
деленного условия. 


Решение 


Использовать последовательности Кот с функциями, выполняющими вы- 
числения по короткой схеме. 


Обсуждение 


Кот добавляет некоторые функции-расширения в основные коллекции, 
то есть класс 1154 получил такие функции, как пар и ег. Однако эти функ- 
ции выполняются жадно, в том смысле, что обрабатывают все элементы 
коллекции. 

Рассмотрим простую задачу: взять числа от 100 до 200, удвоить каждое и вер- 
нуть первое удвоенное число, которое делится на 3 без остатка. В примере 6.1 
показано одно из возможных решений. 


Самый известный пример подобного объяснения: «Монады - это просто моноиды 
в категории эндофункторов», что может быть почти правдой, но не совсем. Совер- 
шенно бесполезное утверждение. 
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Пример 6.1. Поиск первого удвоенного числа, кратного 3 (версия 1) 
(100 ипЕЦ. 200).тар { 1 * 2} ® 

„РИЦег { и %З == 0 } [2] 

„РАГ$Е() 


© 100 вычислений 
@ Еще 100 вычислений (плохо продуманный алгоритм, можно улучшить) 


Недостаток этого решения заключается в крайне низкой эффективности. 
Сначала оно удваивает все 100 чисел в заданном диапазоне, затем выполняет 
операцию взятия остатка от деления для всех 100 результатов, а потом извлека- 
ет первый элемент. К счастью, существует перегруженная версия функции Н\г$%, 
принимающая предикат (лямбда-выражение с одним аргументом, возвращаю- 
щее логическое значение), применение которой показано в примере 6.2. 


Пример 6.2. Поиск первого удвоенного числа, кратного 3 (версия 2) 


(100 ипЕЦ 200).тар { 44 *2} ® 
„НГ {и %З == 0 } [2] 


© 100 вычислений 
@® Только 3 вычисления 


Эта версия #4гз+ обрабатывает элементы коллекции в цикле и останавли- 
вается, достигнув первого, удовлетворяющего предикату. Такие вычисления 
часто называют вычислениями по короткой схеме - они обрабатывают только 
необходимое для достижения условия количество данных. Однако если вы за- 
будете использовать перегруженную версию #4г$*, ваша программа будет вы- 
полнять много ненужной работы. 

Последовательности данных в Кот обрабатываются иначе. В примере 6.3 
демонстрируется еще более оптимальное решение. 


Пример 6-3. Поиск первого удвоенного числа, кратного 3 (лучшая версия) 


(100 ипЕЦ. 2_6000_000).азбедиепсе() ® 
„мар { рглплп("доч Ала $14"); 1 * 2} 
„ЕИ\ег { рглп ("РА егАлд $44"); 11% 3 == 0 } 
„РАг$Е() 


© Преобразование диапазона в последовательность 


Этот код выполнит всего шесть операций до завершения: 


доу пд 100 
РОЦегалд 200 
доу 11 пд 101 
РАЦегалд 202 
доу пд 102 
ЕОЧегллд 204 


Для последовательностей не имеет значения, используете ли вы функцию 
РАЦег, как в примере 6.1, или перегруженную версию {1гз*, как в примере 6.2, 
хотя в последнем случае код будет выглядеть проще. В любом случае будет 
выполнено только шесть вычислений, потому что каждый элемент последо- 
вательности полностью обрабатывается всем конвейером перед переходом 
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к следующему. Обратите внимание: для наглядности верхний предел последо- 
вательности на этот раз был увеличен до двух миллионов, и это никак не по- 
влияло на поведение. 

Между прочим, использованная здесь функция #4 г* сгенерирует исключе- 
ние, если последовательность окажется пустой. Если такое возможно, исполь- 
зуйте вместо нее функцию Аг 0гМи 1. 

Класс бедиепсе предлагает те же функции, что и СоЦес оп, но операции де- 
лятся на две категории: промежуточные и терминальные. Промежуточные опе- 
рации, такие как пар и ег, возвращают новые последовательности. Терми- 
нальные операции, такие как Аг или 05+, возвращают нечто иное. Важно 
запомнить, что без терминальной'операции последовательность не будет об- 
рабатывать никаких данных. 


Последовательность обрабатывает данные, только если определен- 
ный для нее конвейер операций заканчивается терминальной опе- 
рацией. 


В отличие от потоков ]ауа, последовательности КоЙй1 допускают повторное 
выполнение итераций, а случаи, когда это невозможно, явно определены в до- 
кументации. 


6.2. ГЕНЕРИРОВАНИЕ ПОСЛЕДОВАТЕЛЬНОСТЕЙ 


Задача 
Сгенерировать последовательность значений. 


Решение 


Использовать зедиепсебТ, если имеются отдельные элементы; использовать аз- 
бедчепсе, если имеется экземпляр ЦегаЛе; в противном случае использовать 
генератор последовательностей. 


Обсуждение 


Первые два решения реализуются тривиально просто. Функция зедцепсед{ дей- 
ствует точно так же, как аггауоф, 115401 и другие подобные функции. Функция 
азбедиепсе преобразует существующий экземпляр Г(егаЛе (чаще в роли такого 
экземпляра используются списки и другие коллекции) в 5едиепсе. Оба решения 
показаны в примере 6.4. 


Пример 6.4. Создание последовательностей из уже имеющихся значений 


уа\ пимбедиепсе1 = зедиепсе0{ (3, 1, Иди, °5, 9) 
уа\ пимбедиепсе? = 11$401(3, 1, 4, 1, 5, 9).аззедцепсе() 


Обе инструкции создают 5едиепсе<Тп{> из указанных значений или из задан- 
ного списка. 

Намного интереснее, когда требуется генерировать значения на лету и тут 
же преобразовывать их в последовательность, возможно даже бесконечную. 
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Но, прежде чем увидеть, как это реализовать, рассмотрим пример 6.5, где 
представлена функция-расширение для Тп+, которая определяет, является ли 
число простым, пытаясь найти делитель в диапазоне от 2 до квадратного корня 
из числа, на который это число делится без остатка. 


Пример 6.5. Проверка простых чисел 


1трогЕ Ко Ап .маВ. се. 
1трогЕ Ко Ап .маВ.$аг* 


Рип Тпе.А5РгАме() = 
{81$ == 2 || (2. .се(заге (ЕВА . обои е())).фоТпе()) 
„попе { ЧА\15ог -> {1$ % 94\150г == 0 } 


Сначала функция проверяет, равно ли число 2. Если нет, то создает диа- 
пазон от 2 до квадратного корня/из’ данного числа, округленного вверх до 
ближайшего целого числа. Для каждого числа в этом диапазоне функция попе 
возвращает +гие, только если ни одно из значений не делит исходное число 
без остатка. 


Тесты для проверки поведения функции 15Рг1ме включены в репози- 
торий с исходным кодом для этой книги. 


Теперь предположим, что у вас есть некоторое целое число и вам требу- 
ется определить ближайшее простое число, которое больше его. Например, 
если дано число 6, то ближайшим большим простым числом будет 7. Если 
дано число 182, то ближайшим большим простым числом будет 191. Для 9973 
ближайшим большим простым числом будет 10 007. Интересно отметить, 
что в этой задаче нет никакой возможности узнать, сколько чисел придется 
проверить, прежде чем будет найдено следующее простое число. Это одно 
из естественных применений последовательностей. Реализация функции 
пех{Рг\ме показана в примере 6.6. 


Пример 6.6. Поиск ближайшего простого числа больше заданного 


Рип пехЕРгАме(пит: Тпё) = 
депега{е5едиепсе(пим + 1) { 1 +17 ® 
„РГ (Тпе: :А5РгАме) [2 


© Начать последовательность с числа, на 1 больше заданного, и генериро- 
вать каждое последующее число на 1 больше предыдущего 


@ Вернуть первое простое число 


Функция депегафе5едиепсе принимает два аргумента: начальное значение 
и функцию для вычисления каждого следующего значения в последователь- 
ности. Вот ее сигнатура: 


Рип <Т : Апу> депегафебедиепсе( 
сее4: Т?, 
пехЕРипс оп: (Т) -> Т? 

): бедиепсе<Т> 
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В нашем случае зее4 - это начальное число, следующее сразу за указанным, 
а функция пех{Рипс\оп просто увеличивает текущее число на единицу. В соот- 
ветствии с типичной идиомой Кот лямбда-выражение указывается после 
круглых скобок в вызове функции депега*ебедуепсе. Функция #4г5+ возвращает 
первое значение, которое удовлетворяет условию в лямбда-выражении, кото- 
рое в данном случае является ссылкой на функцию-расширение 15$Рг4ле. 

В этом примере функция пех#Рийпе генерирует бесконечную последователь- 
ность целых чисел, пока не найдет первое простое число, которое больше задан- 
ного. Функция #1гз{ возвращает значение, а не последовательность, поэтому 
это - терминальная операция. Без терминальной операции никакие значения 
не будут обрабатываться последовательностью. В этом случае операции Е гз+ 
передается лямбда-выражение - предикат (потому что возвращает логическое 
значение) - и последовательность продолжает генерировать значения, пока 
условие предиката не будет удовлетворено. 


Смотри также 
Рецепт 6.3, где исследуется бесконечная последовательность. 


6.5. УПРАВЛЕНИЕ БЕСКОНЕЧНЫМИ ПОСЛЕДОВАТЕЛЬНОСТЯМИ 


Задача 
Обработать часть бесконечной последовательности. 


Решение 


Использовать генератор последовательностей, возвращающий пи, или одну 
из функций последовательностей, такую как фаКемв Де. 


Обсуждение 


Последовательности похожи на потоки данных в ]ауа. Они поддерживают про- 
межуточные и терминальные операции. Промежуточные операции возвраща- 
ют новые последовательности, а терминальные - нечто иное. Если конвейер из 
вызовов функций последовательностей не содержит терминальной операции, 
то никакие данные не будут течь через последовательность. 

Функция 1 1г5{МРг1мез, показанная в примере 6.7, вычисляет первые № прос- 
тых чисел, начиная с 2. Пример 6.7, показанный ниже, использует функцию 
пех{Рг\ме из примера 6.6, описанную в рецепте 6.2 и повторенную здесь для 
удобства: 

Тип пехЕРг\ме(пит: ТП) = 


депега{ебедиепсе(пим + 1) { 1+1} 
„РАГУЕСТпе: :А5РгАме) 


Эта функция использует функцию-расширение 15Рг\ме из того же рецепта. 

Напомню, что невозможно заранее узнать, сколько чисел нужно проверить, 
чтобы найти необходимое количество простых чисел, поэтому применение 
последовательности является естественным решением задачи. 
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Пример 6.7. Поиск первых М простых чисел 


Рип РАг$ЕМРгАме$ (соупе: Тпё) = 
депегафебедиепсе(2, ::пех&Рг\ме) ® 
.СаКе(соипе) [2] 
„Ко $() [3] 


© Бесконечная последовательность простых чисел, начинающаяся с 2 
@ Промежуточная операция, ограничивающая количество извлекаемых чисел 
© Терминальная операция 


Генерируемая последовательность бесконечна. Функция «аКе - это промежу- 
точная операция без сохранения состояния, которая возвращает последова- 
тельность, состоящую только из первых соуп& значений исходной последова- 
тельности. Если просто вызвать эту функцию без вызова фо11 54 в конце, простые 
числа не будут вычисляться. У вас просто будет последовательность без каких- 
либо значений. Терминальная операция {01154 запускает фактические вычис- 
ления и возвращает результаты в виде списка. 


В 2017 году даже этот неойтимизированный алгоритм, выполняв- 
шийся на МасВоок Рго, сгенерировал 10 000 простых чисел менее 
чем за 50 миллисекунд. Современные компьютеры - очень быстрые. 
К слову сказать, 10-тысячное простое число - это 104 729. 


Другой способ усечения бесконечной последовательности - использовать 
функцию генерации, которая в конце концов возвращает п. Например, 
вместо запроса первых № простых чисел можно потребовать, чтобы все прос- 
тые числа были меньше определенного значения. Соответствующая функция 
рглме$1е5$Твап показана в примере 6-8. 


Пример 6.8. Простые числа меньше определенного значения (версия 1) 


Рип рг4Аме$1е$$Тнап(тах: Тп®): 11$%4<1п&> = 
депегаебедиепсе(2) { п -> 14 (п < мах) пехЕРглме(п) е|\зе пи } 
.{011$Е().9горЬа${(1) 


Функция, передаваемая в вызов депега{еедиепсе, сравнивает текущее значе- 
ние с заданной максимальной величиной из если оно меньше, вычисляет сле- 
дующее простое число, иначе возвращает пи 1, завершая последовательность. 

Конечно, невозможно узнать, будет ли следующее простое число больше за- 
данного предела, поэтому функция фактически создает список, включающий 
первое простое число выше предела. Затем функция ЧгорЁаз* обрезает полу- 
чившийся список перед возвратом. 

В большинстве случаев есть более простой способ решить ту же задачу. На- 
пример, в этой задаче, вместо того чтобы заставлять генерирующую функцию 
возвращать пи 1, можно использовать функцию последовательностей +аКей Де, 
как показано в примере 6.9. 


Пример 6.9. Простые числа меньше определенного значения (версия 2) 


Рип рг4ме$1е$$ТНап(тах: Тп®): 11$%4<1п&> = 
депега{ебециепсе(2, : :пех{Рг\ме) 
„СаКемелДе { 1+ < мах } 
.{011$() 
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Функция таке! Де продолжает извлекать значения из последовательности, 
пока заданный предикат не вернет +гие. 

Оба описанных подхода работают хорошо, поэтому выбор между ними - это 
в основном дело вкуса. 


6.4. ИЗВЛЕЧЕНИЕ ЗНАЧЕНИЙ ИЗ ПОСЛЕДОВАТЕЛЬНОСТИ 


Задача 


Требуется извлекать значения из последовательности, но через заданные ин- 
тервалы. 


Решение 
Использовать функцию $едуепсе в паре с функцией приостановки у\е\9. 


Обсуждение 


зедиепсе — еще одна функция, связанная с повледовательностями. Ее сигнатура 
показана в примере 6.10. 


Пример 6.10. Сигнатура функции 5едцепсе 


ип <Т> зедиепсе( 
ЫосК: зизреп@ 5едиепсебсоре<Т>.() -> Уп 
): бедиепсе<Т> 


Функция зедиепсе генерирует последовательность, выполняя заданный блок 
кода. Блок кода - это лямбда-выражение без аргументов, возвращающее уо\9 
и воздействующее на получателя типа 5едиепсебсоре. 

Все это кажется сложным, но только до первого практического примера. 
Обычно последовательности создаются из существующих данных с помощью 
седцепсе0Т, из коллекций с помощью а$бедиепсе или генерируются с использова- 
нием депега{ебедиепсе и лямбда-выражения. Однако в этом случае вы должны 
указать лямбда-выражение, производящее следующее значение в последова- 
тельности, которое вы вызываете в требуемый момент времени. 

Отличной демонстрацией может послужить генерирование чисел Фибонач- 
чи, как показано в примере 6.11, основанном на примере из документации 
с описанием стандартной библиотеки. 


Пример 6.11. Генерирование чисел Фибоначчи в виде последовательности 
Рип Е\Бопасс\бедуепсе() = зедиепсе { 


уаг тегм$ = Ра1г(0, 1) 


ирДе (гие) { 
уле19({егм$.ЕАг${) 
{егт$ = {егт$.зесоп4 +0 %егм$.РАг$Е + {егм$.зесоп@ 


Лямбда-выражение, передаваемое в вызов функции зедиепсе, начинается 
с создания пары Ра\г, содержащей первые два числа Фибоначчи, 0 и 1. Затем 
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оно использует бесконечный цикл для получения последующих значений. 
Каждый раз, когда создается новый элемент, функция у\е\4 возвращает эле- 
мент #1г5{ полученной пары. 

Функция у\1е14 - это одна из двух похожих функций, являющихся частью 5е- 
диепсебсоре, получателя лямбда-выражения, предоставленного для передачи 
в вызов зедиепсе. Сигнатуры у\е14 и у1е19АЦ и их перегруженных версий по- 
казаны в примере 6.12. 


Пример 6.12. Функции У!е4 и уе[ЧАЦ из $едиепсе$соре 
абзгасЕ зизрепд Фип у1фе\9(уа\ие: Т) 


абзгасе зизрепд Фип узе19АТ1(14егафог: Т&ега*ог<Т>) 
$45реп4 Фип у1е19А11(е1етеп{$: Т&егаЛе<Т>) 
зизреп4 Фип у1е19АТ1 (зедиепсе: Зедиепсе<Т>) 


Задача функции у\е19 - передать значение итератору и приостановить его до 
тех пор, пока не будет запрошено следующее значение. Соответственно, в по- 
следовательности, генерируемой зизрепд-функцией, функция у\е\4 использует- 
ся для вывода отдельных значений. Тот факт, что сама у\е14 является зизрепд- 
функцией, означает, что она прекрасно работает в паре с сопрограммами. 
Другими словами, среда выполнения Кот может передать значение, а затем 
приостановитьтекущую сопрограмму, пока не будет запрошено следующее зна- 
чение. Вот почему бесконечный цикл - цикл ие (+гие) в примере 6.11 - воз- 
вращает значения одно за другим при вызове операцией {аКе в примере 6.13. 


Пример 6.13. Извлечение значений, генерируемых операцией 5едцепсе 


@Тез+ 
Рип `РАг$Е 10 РАБопасс\ пимБег$ Ргот зедиепсе`() { 
уа\ +155 = РАБопасс\5едцепсе() 
„СаКе(10) 
.{011$() 


аззег{Едца1$(11$40+(0, 1, 1, 2, 3, 5, 8, 13, 21, 34), 115$) 


Как нетрудно догадаться, уле19АЦ передает итератору несколько значений. 
В примере 6.14 показан пример, который приводится в документации Ко т. 


Пример 6.14. Функция уге!9АЦ внутри 5едиепсе 


уа\е зедиепсе = зедиепсе { 
уа\ зфагЕ = 9 
у1е19(${аг®) © 
у1е19АЦ(1..5 э%ер 2) [2. 
у1е19АЦ (депегае$едиепсе(8) { 144 * 3 }) ® 
} 


ргАп п (зедцепсе.{аКе(8).{0[1$1()) // [0, 1, 3, 5, 8, 24, 72, 216] 


© Вернет единственное значение (0) 
@ Вернет результат перебора диапазона (1, 5, 5) 


© Вернет бесконечную последовательность, начинающуюся с 8, В которой 
каждое следующее значение является произведением предыдущего на 3 
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Результатом этого кода является последовательность 0, 1, 5, 5, 8, 24, 72,... При 
обращении к последовательности с помощью функции «аКе она вернет ровно 
столько элементов, сколько запрошено. 

Комбинация у\1е14 и узе19АЦ внутри зизрепд-функции позволяет настроить 
последовательность для получения любого желаемого набора сгенерирован- 
ных значений. 


Смотри также 
Раздел о сопрограммах в главе 13, где ключевое слово зизрепд описывается бо- 
лее подробно. 


Глава 


Функции области видимости 


Стандартная библиотека Кот содержит несколько функций, предназначен- 
ных для выполнения блока кода в контексте некоторого объекта. В частности, 
в этой главе обсуждаются функции Те+, гип, арр\у- И а150. 


7.1. Иницидлизация ОБЪЕКТА С ПОМОЩЬЮ 
АРРЕУ ПОСЛЕ СОЗДАНИЯ 


Задача 


Инициализировать объект перед использованием после вызова конструктора 
с аргументами. 


Решение 
Использовать функцию арр\у. 


Обсуждение 


В Кот есть несколько функций области видимости, которые можно приме- 
нять к объектам. Функция арр\у —- это функция-расширение, которая передает 
{915 как аргумент и также возвращает его. В примере 7.1 показана сигнатура 
функции арр\у. 


Пример 7.1. Сигнатура функции арр!у 
А1пИле Фип <Т> Т.арр\у(БЛоск: Т.() -> Уп): Т 


Итак, функция арр1у - это функция-расширение для любого обобщенного 
типа Т, которая вызывает указанный блок кода с {11$ в качестве получателя 
и возвращает его по завершении} 

Рассмотрим практический пример- задачу сохранения объекта в реляцион- 
ной базе данных с помощью фреймворка 5ри!пе. В фреймворке 5рите имеется 
класс $54 пр1е9ЬсТпзег&, основанный на Э4ЬсТепр\а{е, который помогает удалить 
шаблонный код ОВС в ]ауа. 

Пусть имеется сущность 04 сег, которая отображается в таблицу ОЕЕТСЕВ$ 
в базе данных. Написать 5ОГ-оператор Т\5ЕВТ для такого класса не представ- 
ляет большого труда, но есть одна сложность: если первичный ключ гене- 
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рируется базой данных во время сохранения, то его необходимо получить 
и записать в копию сущности, находящуюся в памяти. Для этого в классе 
$1тр1еЧЬсТпзег* есть удобный метод ехесифеАпЧВетигпКеу, который получает ас- 
социативный массив с именами и значениями столбцов и возвращает сгене- 
рированное значение. 

Используя функцию арр\у, функция зауе может получить экземпляр для со- 
хранения и обновить его, записав новый ключ, как показано в примере 7.2. 


Пример 7.2. Сохранение объекта данных и его обновление сгенерированным ключом 


@Кероз\Фогу 
СТаз$ Э4БсоРАсегОАО(рг\уае уа\ )96сТемр1а{е: Э9ЬсТетр\а{е) { 


рг\уаее уа\ 1пзегЕОРАсег = 51мр1е4ЬсТпзегЕ( )4ЬсТепрТа*е) 
„ИИВТаБ1еМаме(“ОРЕТСЕВ $”) 
.и51п9бепега{едКеуСоТитп$ (“14”) 


Рип за\уе(оРАсег: ОЁРАсег) = 
оЕЁАсег.арр\у { 
19 = \лзегЕОЁРАсег .ехесибеАпдВежигпКеу( 
маро*(“гапК” о гапк, 
“Рагз&_ паме” +0 РАг$%, 
“Таз_пате” фо Т1а$*)) 


ИИ к 


Экземпляр 01 4сег передается в блок арр\у как «№5, поэтому его можно ис- 
пользовать для доступа к свойствам гапк, Ё4г$% и Таз+. Свойство 14 обновляется 
внутри блока арр\у, и обновленная сущность о Асег возвращается вызываю- 
щему коду. При необходимости или желании к этому блоку можно добавить 
дополнительную инициализацию. 

Блок арр\у удобно использовать, если результатом должен быть объект кон- 
текста (в этом примере - сущность, о 4сег). Чаще всего он используется для 
дополнительной настройки уже созданных объектов. 


7.2. ИспоЛльЗОВАНИЕ АЕ$О ДЛЯ СОЗДАНИЯ ПОБОЧНЫХ ЭФФЕКТОВ 


Задача 


Вывести сообщение или сгенерировать другой побочный эффект, не прерывая 
выполнения кода. 


Решение 
Использовать функцию а\50. 


Обсуждение 


Функция а\50 - это функция-расшгирение из стандартной библиотеки, реализа- 
ция которой показана в примере 7.3. 


7.2. Использование а[50 для создания побочных эффектов % 123 


Пример 7.3. Функция-расширение а|50 
руБ\Ас 1п пе Фип <Т> Т.а150( 
Ыоск: (Т) -> Уп 

):Т 

Как можно судить по определению функции а\50, она добавляется к любому 
обобщенному типу Т и возвращает экземпляр этого типа после выполнения 
блока, переданного в аргументе. Чаще всего она используется для применения 
функции к объекту, как показано в примере 7.4. 


Пример 7.4. Вывод и журналирование информации с помощью а|50 


уа1 БооК = сгеафеВоок() 
.а150 { ргап (1) } 
„а150 { 1099ег.де{Апопутоц$1099дег().1пРо(1Е.Ко$4г1пд()) } 


Внутри блока объект доступен по ссылке 1+. 

Поскольку а150 возвращает объект контекста, несколько ее вызовов можно 
объединить в цепочку, как показано выше, где код сначала вывел название 
Книги В КОНСОЛЬ, а затем записал информацию о ней в журнал. 

Несмотря на возможность составлять цепочки из нескольких вызовов, все 
же чаще всего функция а150 используется как часть серии вызовов бизнес-ло- 
гики. Например, рассмотрим тест службы геокодирования, представленный 
в примере 7-5. 


Пример 7.5. Тестирование службы геокодирования 


С1а5$ 5\Це(\уа\ паме: 5%гАлпд, 
\уа\ Та иде: БоуЛе, 
уа\ 10п9\ иде: боичЛе) 


// ... внутри тестового класса... 


@Тез& 
Рип `Тае,1п9 оЁ Возфоп, МА`() = зег\асе .деа1ла(“Во$фоп”, “МА”) 
.а150 { 109дег.1пФРо(1+.о5г4па()) } ® 
.гип { 
аззег{ТВае (Та иде, `15`(с1о5еТо(42.36, 0.01))) 
аззег(ТВа{(Топа\фи4е, `15`(с1о5зеТо(-71.06, 0.01))) 
} 


© Журналирование как побочный эффект 


Этот тест можно организовать по-разному, но такое использование а\50 
подразумевает, что главная цель этого кода - выполнение тестов, а вывод на- 
звания местоположения - это лишь побочный эффект. Обратите внимание, что 
использование функций области видимости преобразует весь тест в единое 
выражение, что позволяет использовать более короткий синтаксис. 


Вызов а{50 должен следовать раньше вызова гуп, потому что гиуп 
возвращает значение лямбда-выражения, а не объект контекста. 


124 *% Функции области видимости 


Обратите внимание, что теоретически вызов гип можно заменить вызовом 
арр\у, однако тесты ий должны возвращать Уп. Вызов гип в примере 7.5 воз- 
вращает такой результат (потому что утверждения ничего не возвращают), 
а арр\у - нет, поскольку она возвращает объект контекста. 


Смотри также 
Рецепт 7.1, где обсуждается функция арр\у. 


7.5. Использовднигжх«УНКЦИИ (ЕТ И ОПЕРАТОРА «Элвис» 


Задача 


Выполнить блок кода, только если/ссылка не равна пи, в противном случае 
вернуть значение по умолчанию. 


Решение 


Использовать функцию 1е{ с оператором безопасного вызова и с оператором 
«Элвис». 


Обсуждение 


Функция 1е{ - это функция-расширение из стандартной библиотеки для любо- 
го обобщенного типа Т, реализация которой показана в примере 7.6. 


Пример 7.6. Реализация функции [Е{ 


руБ\Ас 1пле Фип <Т, В> Т.1е*( 
Ыоск: (Т) -> В 

): В 

Важно запомнить, что 1е{ возвращает результат выполнения блока, а не объ- 
ект контекста. То есть фактически она преобразует объекты контекста подобно 
функции пар. Допустим, что вам требуется написать функцию, которая при- 
нимает строку и заменяет первую букву в ней заглавной буквой, но при этом 
пустые строки и ссылки пи 1 должны обрабатываться особым образом, как по- 
казано в примере 7.7. 


Пример 7.7. Преобразование первой буквы в строке с обработкой особых случаев 


Рип ргосе$$5г1па($Ег: 54г4па) = 
54г.1е* { 
ибеп { 
1Е.15Етреу() -> “Етр®у 
ТЕ. 1 5ВТапК() -> “ВЛапК” 
е15е -> 1{. сара те() 


„ 


3 


Обычно вполне достаточно вызвать функцию сар\а1те, но для значения 
пи| и пустых строк она не даст ничего полезного. Функция \1е{ позволяет за- 
ключить в блок условное выражение ипеп, обрабатывающее все требуемые слу- 
чаи и возвращающее «преобразованную» строку. 


х. 
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Ситуация становится еще более интересной, когда аргумент имеет тип, под- 
держивающий значение пи, как показано в примере 7.8. 


Пример 7-8. То же самое, но.с аргументом, поддерживающим значение пиЦ 


Рип ргосе$$МиДаБЛегАпд ($: 5119?) = 
$4г?. [еф { о 
ибеп { 
1Е.15Етрфу() -> “Етрфу 
ТЕ. 1 5ВТапК() -> “ВЛапК” 
е15е -> 1{. сара те() 


„ 


3 
}?: “ми” 9 


© Безопасный вызов 1е{ 
@ Оператор «Элвис» для обработки аргумента со значением пи 


Обе функции возвращают значениетипа 5+г\пд, который легко определяется 
из тела функции. 

В этом случае комбинация оператора безопасного вызова ?., функции 
1её и оператора «Элвис» ?: помогает обрабатывать все возможные случаи. 
Это распространенная в Кот идиома обработки случаев, когда могут по- 
являться значения пи 1. 

Многие ]ауа АР! (например, Ве${Тепр\Та%е или МебС\Лепе в 5ргп) возвраща- 
ют значения пи\1 при отсутствии результата, и комбинация безопасного вы- 
зова, блока 1е+ и оператора «Элвис» позволяет эффективно обрабатывать их. 


Смотри также 


Рецепт 7.2, где обсуждается функция а150. Рецепт 7.4, где демонстрируется при- 
менение функции 1е{ для замены временных переменных. 


7.4. ИСПОЛЬЗОВАНИЕ 1ЕТ С ВРЕМЕННЫМИ ПЕРЕМЕННЫМИ 


Задача 


Обработать результат вычислений без сохранения результата во временной 
переменной. 


Решение 


Добавить вызов 1е{ квычислению июбработать результат в лямбда-выражении 
или в функции по ссылке. 


Обсуждение 

В документации с описанием функций области видимости на веб-сайте 
Кош показан интересный вариант использования функции \1е*. Вариант этот 
(он приводится в примере 7.9) создает изменяемый список строк, получает их 
ДЛИНЫ и фильтрует результат. 
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Пример 7.9. Пример использования (Е из электронной документации (перед рефакторингом) 


// До 


\уа1 питбег$ = мифаБ1е1 1540 (“опе”, “мо”, “Егее”, “Роиг”, “РА ме”) 
уа1 гези1411$Е = питбег$.мар { 1*.1епдЕВ }.Р ег { %“>3} 
ргАп п (гези $1) ® 


0 Результат присваивается временной переменной для вывода 


После рефакторинга - замены временной переменной блоком 1е*+ - код вы- 
глядит, как показано в примере 7.10. 


Пример 7.10. После замены временной переменной функцией (Е 


// После 
уа1 питбег$ = мифаБ1е1 1540 (“опе”, “мо”, “Егее”, “Роиг”, “РА ме”) 
питБег$.тар { 1*.1епаеВ }.Е\ег { 14 > 3 }.1е{ { 

ргАп п (14) 

// сюда можно добавить вызовы других функций, 

// если потребуется 


Идея состоит в том, чтобы вместо присваивания результата временной пе- 
ременной вызвать функцию 1е*, использующую результат в качестве контекст- 
ной переменной, которую можно вывести (или сделать что-то еще) в блоке 
кода. Если достаточно просто вывести результат, то код можно сократить еще 
больше, как показано в примере 7.11. 


Пример 7.11. Использование ссылки на функцию в блоке |е{ 


уа1 питбег$ = мифаБ1е1 1540 (“опе”, “мо”, “Егее”, “Роиг”, “РА ме”) 
пимфег$.тар { 1*.1епдЕВ }.Р\ег { 14 > 3 }.1е%(: :рглп п) 


Рассмотрим немного более интересный пример: класс, обращающийся 
к удаленной службе в Ореп Мойфу, которая возвращает количество космонав- 
тов, находящихся в данный момент в космосе, как описано в рецепте 11.6. 
Служба возвращает данные в формате ]ауа5сире ОБесЕ МокаНоп (]50М№), а мы 
должны преобразовать эти данные в экземпляры классов, которые мы снова 
увидим в примере 11.17: 


Чака с\а$$ АзгоВези{( 
уа\ мез5аде: 5&г1пд, 
уа\ питфег: МитБег, 
уа1 реор1е: 115%<А$$19пмеп{> 


) 


Чака с\а$$ Аз51аптеп{( 
уа1 сгаЁ: 5%г\пд, 
уа\ паме: $4г1пд 


Код в примере 7.12 использует метод-расширение ИВЕ.геадТех* и библио- 
теку Соое Сзоп, чтобы преобразовать данные в формате ]ЗОМ в экземпляр 
Азговези1+. 
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Пример 7.12. Вывод имен космонавтов, находящихся в космосе 


($оп().Ёгот3зоп( 
ОВЕ(«ВЕЕр: / /ар\.ореп-по{\Фу.ога/а$го$. ]зоп») .геадТех*(), 
АзЕгоВези +: :С1аз$. ]ама 
).реор\е.тар { 1*.паме }.1е{(::рглп п) ® 


Ф Функция Те{ (или а{50) используется для вывода [1$1{<5г4пд> 


В этом случае код в вызове 65оп()..Ёгот)зоп преобразует данные из формата 
]ЗОМ в экземпляр Аз{говези\*. Затем функция пар преобразует экземпляры Аз- 
$19птепе в список строк, представляющих имена космонавтов. 

Вот вывод этой программы, полученный в августе 2019 г. (в одну строку): 


[А\ехеу ОусРАпАп, Мск Надие, САг1$ па Косй, 
А\1ехапдег 5Куог%зо\у, Шиса РаггАфапо, Апдгем Могдап] 


В примере 7.12 вызов 1е{ можно заменить вызовом а\50. Разница лишь втом, 
что 1е+ возвращает результат выполнения блока (УпА+ в случае с рг4п1п), а а150 
возвращает объект контекста (115{<54гАпд>). Ни то, ни другое не использует- 
ся после печати, поэтому разница для данного примера не имеет значения. 
Использование а\50, возможно, выглядело бы идиоматичнее, потому что она 
чаще применяется для получения побочных эффектов, таких как вывод. 


Смотри также 


Рецепт 7.5, где описывается применение функции 1е{ с операторами безопас- 
ного вызова и «Элвис» для обработки возможных значений пи\1. Рецепт 7.2, где 
описывается функция а\50. 


Глава 


Делегаты в Кот 


Эта глава рассказывает о делегатах в языке Кот. Здесь вы узнаете, как ис- 
пользовать делегаты, имеющиеся в стандартной библиотеке, включая Та2у, 
оБзегуаБЛе, уефоа Ле и по&№и Ц, а также создавать свои собственные. Делегаты 
классов позволяют заменить наследование композицией, а делегаты свойств — 
использовать свойства из другого класса. 

Помимо основных приемов, в этой главе также показана реализация неко- 
торых стандартных делегатов в библиотеке, чтобы вы могли увидеть хорошие 
примеры идиоматического использования. 


8.1. РЕАЛИЗАЦИЯ КОМПОЗИЦИИ ДЕЛЕГИРОВАНИЕМ 


Задача 


Создать класс, содержащий экземпляры других классов и делегирующий им 
выполнение операций. 


Решение 


Создать интерфейсы, содержащие методы делегирования, реализовать их 
в классах и создать класс-обертку, используя ключевое слово Бу. 


Обсуждение 


В современном объектно-ориентированном программировании наблюда- 
ется тенденция, когда предпочтение отдается композиции, а не наследова- 
нию*, как способу добавления новых возможностей без образования тесных 
связей между классами. Ключевое слово Бу в языке Кот позволяет классу 
экспортировать все общедоступные функции во внутреннем объекте через 
методы контейнера. 

Например, смартфон имеет в своем составе телефон, камеру и множество 
других компонентов. Если представить смартфон как объект-обертку, а теле- 
фон и камеру - как внутренние объекты, то цель создания класса смартфона 
можно определить как вызов соответствующих функций внутренних объектов. 


Не очень удачная шутка: родители Бетховена не давали ему семейных денег, требуя 
бросить писать музыку, но он все равно предпочел композицию наследству. (Честно 
говоря, это неправда.) 
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Чтобы реализовать такой класс в Кот, нужно определить интерфейсы, опи- 
сывающие открытые методы во внутренних объектах. Рассмотрим для при- 
мера интерфейсы П\а\аБЛе и 5парра1е, которые реализуют классы РВопе и Самега 
(см. пример 8.1). 


Пример 8.1. Интерфейсы и классы внутренних объектов 


1пфегРасе Ола\аБе { 
Рип Ч1а1(питбег: 5%г4п9): $4г1п9 
} 


СТаз$ РНопе : Ола1аБе { 
оуегг\4е Рип Ч1а1(питБег: $4г4па) = 
“Бла пд ФпитБег...” 


3 


1пфегРасе ЗпарраБ\е { 
Рип фаКеРлсфиге(): 5%гАпд 
} 


СТа$$ Самега : ЗпарраЛе { 
оуегг\4е Кип {аКеРлсфиге() = 
“ТаКАпд расфиге...” 


Теперь можно определить класс бтагЕРВопе, который создает экземпляры 
телефона и камеры в конструкторе и делегирует им все общедоступные функ- 
ции, как показано в примере 8.2. 


Пример 8.2. бтаиРВопе делегирует выполнение операций внутренним экземплярам 


СТа$$ бмагЕРВопе( 
рг\\афе уа1 рбопе: Ота\аБЛе = РНопе(), 


рг\уаЕе уа\ самега: ЗпарраБ\е = Сатега() 
) : Ла\ае Бу рвопе, 5парраБ\е Бу сатега ® 


© Делегирование с помощью ключевого слова Бу 


Теперь, создав экземпляр 5таг&РВопе, можно вызывать все методы в Рвопе 
и Самега, как демонстрируют тесты в примере 8.3. 


Пример 8.3. Тесты для Зта(РНопе 


4троге огд. и п1. )ир\{ег.ар\.Тез* 
1троге огд. ип. )ир\\ег.ар\..АззегЕТопо/. * 


С1а$$ бмагЕРВопеТезе { 
ргА\маЕе уа\ зтагЕРВопе: ЗмагЕРНопе = 5магЕРНопе() ® 


@Те$+ 
Рип `Ола\Алд де\едафез фо 1пфегпа1 рвопе`() { 
а$зег{Едиа1$(“О\а11п9 555-1234...”, 
<тагРВопе. 44 а1(“555-1234”)) [2] 


. 
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@Те$& 
Рип `ТаК1фпд рАсфиге де\едафе$ %о 1п%егпа{ самега`() { 
аззегЕадца1$(“ТаКАпа раскиге...”, 
смаг&РВопе. сакеРАсфиге()) @ 


© Создание экземпляра 5тагЕРКопе вызовом конструктора без аргументов 
@ Вызов делегированных функций 


Сами внутренние объекты (экземпляры Рнойе.И.Сатега) недоступны из-за 
пределов 5тагЕРопе; доступны только их общедоступные функции. Классы 
Ропе и Сапега могут иметь много других функций, но доступны только те, кото- 
рые объявлены в соответствующих интерфейсах Гл а1аБЛе и бпарра3\е. Необходи- 
мость определения дополнительных интерфейсов кажется напрасной работой, 
но она помогает сохранить отношения ясными. 

Если сыграть в уже привычную игру в Пе, скомпилировать программу на 
Ко 1 в байт-код и затем декомпилировать ее в исходный код на ]ауа, то полу- 
чится фрагмент, показанный в примере 8.4. 


Пример 8.4. Часть декомпилированного байт-кода класса ЗтагРПопе 


рус Е4па1 с\а$$ бтагЕРВопе 1мр\емепЕ$ Ола\аБ\е, бпарраБе { 
ргА\мафе #Апа\ Ота1аБЛе рБопе; © 
рг\\аЕе Р4па1 бпарраБ\е сапега; © 


руб с бтагЕРВопе( @Мо{ Ми. Ола\аБЛе рКопе, @М№о№ 11 бпарраБЛе самега) { 
А за 


ЕВА $.рбопе = рНопе; 
Р1$.самега = саптега; 


} 


@МоЕМит 
руб Ас 54г1пд Ч\1а1(@МоЕМи. 5%г1пд пимфег) { 
гефигп {115 .рНопе. Ч1а\(питбег); @ 


} 


@Моемит 
руб Ас 54г1пд фаКеР\Асфиге() { 
гефигп {11$ .самега. аКеР\сфиге(); @ 


} 
И а 


© Поля стипом интерфейсов 
@ Делегирующие методы 


Внутренне класс бмаг{РНопе определяет делегированные свойства с типами 
интерфейсов. Соответствующие экземпляры класса создаются в конструкторе, 
а делегирующие методы вызывают соответствующие методы в полях. 


Смотри также 
Рецепт 8.6, где рассказывается о делегировании свойств. 
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8.2. Использование ддеЛЕГАТА Г А2У 


Задача 


Отложить инициализацию свойства до момента, когда это действительно ста- 
нет необходимо. 


Решение 
Использовать делегат Тагу из стандартной библиотеки. 


Обсуждение 
Ключевое слово Бу используется в КоШп для обозначения свойств, методы 
чтения и записи которых реализованы другим объектом, который называ- 
ют делегатом. В стандартной библиотеке есть несколько функций-делегатов. 
Одна из самых популярных - Та2у. 

Чтобы использовать ее, необходимо определить лямбда-выражение в форме 
() -> Т, цель которого - вычислить значение при первой попытке обратиться 
к свойству, как показано в примере 8.5. 


Пример 8.5. Сигнатуры функции [а2у 
Фип <Т> Таху(1п а тег: () -> Т): Га2у<Т> © 


Фип <Т> Тату( [2] 
моде: ГагуТВгеа45аТе{умоде, 
да ег: () -> Т 

): Гаху<Т> 


Фип <Т> Тагу(1оск: Апу?, Аа тег: () -> Т): 1ару<Т> ® 


© По умолчанию синхронизируется по самому себе 


9 Определяет, как синхронизируется инициализация между несколькими 
потоками выполнения 


© Использует для синхронизации указанный объект 


Версии без свойства поде по умолчанию получают значение [а2уТгеаЧае{уМоде. 
<УМСНАОМТ7ЕО. Если лямбда-выражение 1" аЦ тег сгенерирует исключение, будет 
выполнена повторная попытка инициализировать значение при следующем до- 
ступе. Простейший способ применения делегата 1а2у показан в примере 8.6. 


Пример 8.6. Откладывание инициализации свойства до первой попытки обращения к нему 


уа1 {А ла{еАпзмег: Тпё Бу Тар2у { 
ргАп п(“сотрипд Не апзмег”) 
42 


Идея состоит в том, чтобы отложить инициализацию значения и лма{еАпзиег 
до первого обращения к нему, в ходе которого вычисляется лямбда-выраже- 
НИЕ. Тагу — это функция, которая принимает лямбда-выражение и возвращает 
экземпляр !а2у<Тп%>, который выполнит лямбда-выражение при первом обра- 
щении к свойству. 
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То есть следующий код выведеттекст «сотри пе Фе апз\м’ет» только один раз: 


рглп п (Шла еАпзиег) 
рглп л( Шла еАпзиег) 


Первое обращение к и\\лматеАпзиег выполнит лямбда-выражение и вернет 
число 42, которое будет сохранено в переменной. Внутренне Кот сгенери- 
рует специальное свойство слименем пуАпзиег$Че\едате типа 1а2у, которое будет 
использовано как кеш для хранения значения. 

Аргумент типа Га2уТАгеад5аРеуМоде принимает элемент перечисления, один 
из следующих: 


5УМСНКОМТ7ЕБ 


требует использования блокировки, чтобы гарантировать возможность ини- 
циализации экземпляра [Ёа?у только из одного потока выполнения; 


РИВЕТСАТТОМ 


функцию-инициализатор можно вызывать несколько раз, но использовано 
будет только первое возвращаемое значение; 


МОМЕ 


блокировка не используется. 


Если в аргументе 1оск указан объект, делегат синхронизируется по этому 
объекту при вычислении значения. В противном случае он синхронизируется 
по самому себе. 

Делегат Тагу удобно использовать, когда требуется создавать экземпляры 
сложных классов, но суть от этого не меняется. 

Кроме того, реализация Та2у в стандартной библиотеке не следует типич- 
ному шаблону реализации остальных делегатов. Функция Та2у — это функция 
верхнего уровня, в то время как большинство остальных делегатов являются 
частью экземпляра Ое\еда*ез, обсуждаемого в других рецептах в этой главе. 


8.5. ГАРАНТИЯ НЕРАВЕНСТВА ЗНАЧЕНИЮ МИН. 


Задача 


Вызвать исключение, если значение не было инициализировано до первого 
обращения к нему. 


Решение 


Использовать функцию по*№1 в роли делегата, который сгенерирует исключе- 
ние, если значение не было инициализировано до первого обращения. 


Обсуждение 


Обычно свойства в классах Ко п инициализируются во время создания 
экземпляров. Один из способов отсрочить инициализацию - использовать 
функцию по{М11, которая предоставляет делегата, генерирующего исключе- 
ние, если свойство не было инициализировано до обращения к нему. 
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Пример 8.7 объявляет свойство зо ЧМо{Вем/Д, которое должно быть инициа- 
лизировано где-то еще перед его использованием. 


Пример 8.7. Требование инициализации перед обращением, без определения способа ини- 
циализации 


уаг $Ноц1ЧМ№+Веми1: 5+г4па Бу Ое\едафез .по Ми 1<5г4пд>() 


Тесты в примере 8.8 показывают, что если попытаться получить доступ 
к свойству до присваивания ему некоторого значения, Кот сгенерирует ис- 
ключение 11\1еда15а%еЕхсер оп. 


Пример 8.8. Проверка поведения делегата по{МиЦ 


@ТезЕ 

Рип ‘опа ед уа\ие {Вгоиз ехсерЕТоп`() { 
аззегЕТАгом5<ПДеда15а+еЕхсер01>2{ $Ло\1 ЧМ о{Веми. } 

} 


@ТезЕ 

Рип `1п Дате уа\ие {еп геёглеме 1*`() { 
$Ноц1Ч№о%Веми 1 = “Нео, Мог!” 
аззег(бое$Мо{ТВАгом { $<Вои1Ч№+Вемилд. } 
аззег{Едуа1$(“Не\Ло, Мог14!”, зВои19Мо{Веми.) 


Это поведение достаточно прямолинейное, но если заглянуть в реализацию 
в Реезагез.КЕ в стандартной библиотеке, можно заметить немало интересного. 
Сокращенная версия этого файла показана в примере 8.9. 


Пример 8.9. Реализация в стандартной библиотеке 
обЗесЕ Бе1едафе$ { © 
Фип <Т : Апу> по&М№Д(): ВеадигАеРгорёг%у<Апу?, Т> = №+МиЦМаг() @ 


// ... другие функции обсуждаются в других рецептах... 


3 


рг\уае с1аз$ Мо&МиЦ\аг<Т : Апу>() : ВеадигАкеРгорег%у<Апу?, Т> { [3 
рг\уафе уаг уа\ие: Т? = пи. 


о\уегг14де Рип де\/а\ие({Р1$Ве!: Апу?, ргорегфу: КРгорегфу<*>): Т { 
гефигп уа\ше ?: {Бгом ТЛеда15{афеЕхсер \оп( 
“Ргорегфу ${ргорегфу.пате} $Ноу\49 Бе 1п1{1а\А ед БеФоге де{.”) 
} 


о\уегг14де Рип зе\/аие({Р1$ВеР: Апу?, ргорегфу: КРгорегфу<*>, уа\ше: Т) { 
61$ .уа\ие = уа\ше 
} 


© реедахе$ — это синглтон - объект-одиночка (объект, а не класс) 
@ Фабричный метод, возвращающий экземпляр класса №№ Маг 
© Приватный класс, реализующий Веадиг\еРгорег®у 


Ключевое слово оБ)ес+ используется для определения единственного эк- 
земпляра Бе\еда{ез, поэтому функция по{№1. действует подобно статической 


х. 
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функции в ]ауа. Этот фабричный метод создает экземпляр приватного класса 
№ +МиП\аг, который реализует интерфейс Веадиг\{ерРгорег\у. 

Как обсуждается в рецепте 8.6, при разработке своих делегатов не требу- 
ется реализовать этот интерфейс (или родственный ему интерфейс Веа40ту- 
Ргорегфу, определяющий неизменяемое свойство), но требуется добавить два 
показанных метода. Функция зе{\/а1ие в №{Ми\/аг просто сохраняет передан- 
ное значение, а функция де \/а\ие сравнивает значение с пи\1 и либо возвра- 
щает его, либо генерирует исключение ПЦ1еда\5+а{еЕхсер\оп9. 

Эта комбинация класса-синглтона, фабричного метода и приватного класса 
реализации - обычная идиома в Кот. Если вы решите написать своего деле- 
гата, используйте этот шаблон. 


8.4. Использование делеГАТОВ ОВЗЕВУАВЕЕ И УЕТОАВЕЕ 


Задача 
Перехватить попытку изменения свойства и, если потребуется, отменить ее. 


Решение 


Использовать функцию оБзегуа\е для определения попытки изменения 
и функцию уефоаМе с лямбда-выражением, принимающим решение об отме- 
не изменения. 


Обсуждение 


Функции оБзегуаЛе и уефоаЛе находятся в объекте Обе\едате$, о котором расска- 
зывалось в рецепте 8.5 -Они просты в использовании, но их реализации демон- 
стрируют рекомендуемый пгаблон для разработки своих делегатов. 

Однако, прежде чем вдаваться в подробности, рассмотрим порядок ис- 
пользования этих функций. В примере 8.10 показаны сигнатуры этих двух 
функций. 


Пример 8.10. Сигнатуры функций обегуаЦЩе и уоаЩе 


ип <Т> обзегуаБЛе( 

ла Маше: Т, 

опСпапде: (ргорегфу: КРгорегфу<*>, о14\/а\ие: Т, пем\/а\ие: Т) -> Уп 
): Веадиг\еРгорегу<Апу?, Т> 


Рип <Т> уефоаБ1е( 

ла Маше: Т, 

опСвапде: (ргорегфу: КРгорегфу<*>, о14\/а\ие: Т, пем\/а\ие: Т) -> Воб1еап 
): Веадиг\еРгорегу<Апу?, Т> 


Обе фабричные функции принимают начальное значение типа Т и лямбда- 
выражение и возвращают экземпляр класса, реализующего интерфейс Веад- 
Мг ЕеРгорег\у. Как показывает пример 8.11, использовать их совсем несложно. 


Не самая удачная шутка: автор живет в восточном Коннектикуте, поэтому ПДеда\- 
бфахеЕхсер\оп означает «Нью-Йорк». 
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Пример 8.11. Использование функций об5егуаЦЩе и уеоае 


уаг иа{сКед: Тпе Бу Ое\еда{е$ .оБзегуаБЛе(1) { ргор, 019, пем -> 
ргАп п(“${ргор.паме} свапдед Ргом $019 +0 $пем”) 
} 


уаг сресКед: Тпе Бу Бе\еда*е$ .уефоаБЛе(9) { ргор, о19, пем -> 
ргАп п (“Тгу4лд о сПапде ${ргор.паме} Ргом $014 +0 $пем”) 
пеи >= 0 


Переменная маесвед имеет тип Тп{ и инициализируется значением 1. Вся- 
кий раз, когда она изменяется, выводится сообщение, показывающее старое 
и новое значения. Переменная свесКед тоже имеет тип Тп{ и инициализирует- 
ся значением 0. Но для этой переменной разрешены лишь неотрицательные 
значения. Лямбда-выражение в аргументе возвращает {гие, только если новое 
значение больше или равно 0. 

Тест для переменной ма*свед, представленный в примере 8.12, демонстриру- 
ет, что ее значение изменяется в точности так, как ожидается. 


Пример 8.12. Тест для переменной \ууаеспеа 


@Тез+ 
Рип `иафсреф уаглаБЛе ргАпф$ о19 ап пем уа\иез`() { 
аззег{Едица1$(1, мафсвед) 
мафсвед *= 2 
аззег{Едица1$(2, мафсвед) 
мафсвед *= 2 
а5зег{Едуа1$(4, мафсвед) 


Этот тест выведет в консоль: 


маесвеф спапдед Ргом 1 фо 2 
иаесвед спапдед Ргом 2 фо 4 


Тест для переменной свесКед с делегатом уефоаБЛе, представленный в при- 
мере 8.13, демонстрирует, что она принимает только значения, большие или 
равные 0. 


Пример 8.13. Тест для переменной спескед 


@ТезЕ 
Рип `уефо уа\иез 1ез$ {Нап 2его`() { 
аззег{А\Д ( 
{ аззегЕЕаца1$(0, срескеда) }, 
{ спескед = 42; аззег{Еаца1$(42, спескед) }}, 
{ спесКед = -1; аззегЕаца\$(42, сКескКед) 1; 
{ спескед = 17; аззег{Еаца1$(17, сКескед) } 
) 
} 


Попытки присвоить переменной сНесКед значения 42 и 17 заканчиваются 
успехом, но попытка присвоить -1 отклоняется. 

Обе функции просты в использовании, но, опять же, их реализации представ- 
ляют особый интерес. Так же как по{№11, функции оБзегуае и мефоае являются 
фабричными функциями в синглтоне ба еда{ез, как показано в примере 8.14. 


. 
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Пример 8.14. Фабричные функции в Ве[едате$ 


оБ]есЕ Ое1едаез { 
//... другие ... 


1пИле Фип <Т> обзегуаБЛе (Ап Та\\Уаше: Т, 
сго$$1п пе опСВапде: (ргорег%у: КРгорегфу<*>, 
о14\а\ие: Т, пем/а\ие: Т) -> Уп1): ВеадИг\еРгорег%у<Апу?, Т> = 
об3есе : ОБзегуаЛеРгорег%у<Т> (1п^ 41а \/а\ие) { 
оуегг\4е Рип аЁегСВапде(ргорег%у: КРгорегфу<*>, 
о14\а\ие: Т, пемМа\ие: Т) = опСВапде(ргорегузх о19\а\ие, пем\/а\ие) 


} 


1пИле Фип <Т> уефоаБЛе (111 1а\\Уа\ие: Т, 
сго$$1п Але опСВапде: (ргорег%у: КРгорегфу<*>, 
о14\а\ие: Т, пем\а\ие: Т) -> Воо\еап): Кеадиг\еРгорег%у<Апу?, Т> = 
об3есе : ОБзегуаЛеРгорег%у<Т> (1п1а\/а\ие) { 
оуегг\4е ип БеРогеСвапде(ргорегеу: КРгорегфу<*>, 
о14\а\ие: Т, пем/а\ие: Т): Воо\еап = 
опСВапде(ргорегеу, о14\/а\ие, пем\Ма\ие) 


Реализации, мягко говоря, выглядят сложными. Первое, что следует отме- 
тить, — обе функции возвращают объект типа 065егуаЛеРгорегуу. Этот класс по- 
казан в примере 8.15. 


Пример 8.15. Класс ОБзегуаеРгорегу для передачи делегата 


абзгасе с1а$$ ОБзегуаЛеРгорегку<Т> (Ап 1а1\Ма\ие: Т) : Веадигл«еРгорег{фу<Апу?, Т> { 
рг\\ае уаг уа\ие = 1 а \аше 


ргофесЕеЧ ореп Кип БеРогеСвапде(ргорег%у: КРгорег%у<*>, 
о14\а\ие: Т, пем\/а\ие: Т): Воо\еап = {гие 


ргофесее4 ореп Кип аЁ{егСВапде(ргорегфу: КРгорег%у<*>, 
о14\а\ие: Т, пем\а\ие: Т): Уп {} 


о\уегг1де Рип де\/аие(+Р1$Ве{: Апу?, ргорегфу: КРгорегфу<*>): Т { 
гефигп уа\ше 


} 


оуегг\4е Фип зе\а\ие(+Р1$Веё: Апу?, ргорегфу: КРгорег%у<*>, уа\ше: Т) { 
уа\ о14\/а1ие = №15 .уа\е 
АЕ (!БеРогеСВапде(ргорег®у,' о14\/а\ие, уа\ие)) { 
гефугп 


} 


81$.уа\ие = уа\ие 
аР{егСВапде(ргорегфу, о149\а\ие, уа\ие) 


Класс хранит свойство любого обобщенного типа Т и реализует интерфейс 
ВеаФиг\‹еРгорегуу. Это означает, что для него необходимо предоставить функ- 
ции де\/аше и зе \/а\ше с указанными сигнатурами. В данном случае де*\а\ие 
просто возвращает свойство. 
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Функция зе \а\ие выглядит несколько интереснее. Она запоминает теку- 
щее значение, а затем вызывает метод БеРогеСВапде. Если он вернет {гие (зна- 
чение по умолчанию равно *гие), то свойство изменяется и вызывается функ- 
ция аЁ+егСВапде, которая по умолчанию ничего не делает. 

Это абстрактный класс с открытыми функциями БефогеСвапде и аЁ%егСвапде, 
которые также отмечены как рго*естед. Обе имеют реализации по умолчанию, 
но подклассы могут переопределять эти функции. 

Вот тут и пригодятся реализации из примера 8.14. Функция обзегуаЛе соз- 
дает объект, который раситиряет ОБ зегуаеРгорег{у и переопределяет функцию 
аЁ{егСВапде, замещая ее лямбда-выражением опСпапде. Поскольку БеРогеСВапдед 
не переопределяется, эта функция просто возвращает {гие, гарантируя изме- 
нение свойства. 

Функция уефоае тоже создает объект из класса, расппиряющего ОБ5егуаеРго- 
регуу, но в этом случае переопределяется только функция БефогеСвапде4д. Лямб- 
да-выражение, заменяющее ее, передается в аргументе и должно возвращать 
логическое значение, которое определяет возможность изменения свойства. 

И снова работа по созданию класса ОБ5егуаЛеРгорегфу для реализации интер- 
фейса Веадиг\ХеРгорегху, но с дополнительными методами жизненного цикла, 
упрощает реализацию функций оБзегуаЛе и ме{оаБе. 


т(пе и сго$$тИпе 


Ключевое слово 1п Але требует от компилятора избегать создания нового 
объекта только для вызова функции и заменять вызов фактическим исход- 
ным кодом, составляющим тело функции. 

Иногда встраиваемые (1пАлпе) функции передаются в лямбда-выражения 
как параметры и должны выполняться в другом контексте, например в кон- 
тексте локального объекта или вложенной функции. Такой «нелокальный» 
поток управления недопустим в лямбда-выражениях. В показанных приме- 
рах лямбда-выражение опСвапде выполняется в контексте функций оБзегу- 
аЛе или уефоаБТе, а не класса, расширяющего ОБзегуаЛеРгорег\у, поэтому 
необходимо использовать модификатор сго$з1ппе. 


Комбинация фабричных функций внутри синглтона, которые настраивают 
экземпляр класса делегата, является мощным шаблоном. 


8.5. Использовдниг ассоциативных 
МАССИВОВ В РОЛИ ДЕЛЕГАТОВ 


Задача 
Использовать ассоциативный массив для инициализации объекта. 


Решение 


Ассоциативные массивы в КоЙт уже реализуют функции де\Ма\ие и зе \/аше, 
необходимые делегатам. 
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Обсуждение 


Если значения, необходимые для инициализации объекта, находятся в ассоциа- 
тивном массиве, то можно автоматически делегировать свойства класса это- 
му ассоциативному массиву. Например, пусть есть класс Ргодес*, как показано 
в примере 8.16. 


Пример 8.16. Класс данных Рго]есЕ 


Чака с1а$$ Рго]ес®(ма\ мар: МифаБЛеМар<5{г4пда, Апу?>) { 
уа\ паме: 54г4па Бу мар © 
уаг рглогАу: Тпе Бу мар © 
уаг сомр\е{ед: Воо1еап Бу мар ® 


© Делегирование аргументу пар 


В этом случае конструктор Рго)есё принимает аргумент типа МифаЛеМар 
и инициализирует свойства значениями его ключей. Для создания экземпля- 
ра типа Рго3ес{ требуется ассоциативный массив, как показано в примере 8.17. 


Пример 8.17. Создание экземпляра’ Рго]есЕ на основе ассоциативного массива 


@Тез+ 
Рип `це мар Че\едаее Рог Рго]ес*`() { 
уа1 рго)есе = Рго}ес*( 
пиаБЛеМаро{( 
“паме” фо “Ёеагп Ко”, 
“рглог1 фу” Фо 5, 
“сотр\ефеф” фо +гие)) 


аззег{А ( 
{ аззегЕЕаца1$(“Геагп Ко Лп”, рго)ес*.паме) }, 
{ аззегЕЕаца1$(5, ргодесе.рг\лог\ у) }, 
{ аззегЕТгие(рго]ес&.сотр\ефед) } 


Это возможно, потому что МифаБеМар имеет функции-расшгирения зе\а\ие 
и де{\аше с соответствующими сигнатурами, необходимые для того, чтобы 
быть делегатом Веадиг\{ерРгорег\у. 

Однако у кого-то из вас может возникнуть вопрос: зачем нужен дополни- 
тельный уровень косвенности? Иначе говоря, почему бы просто не сделать 
свойства частью конструктора и неиспользовать ассоциативный массив? 
Как отмечается в документации, этот механизм может использоваться в та- 
ких приложениях, как «анализ ]ЗОМ или выполнение других динамических 
действий». 

Логично. Тест в примере 8.18 предполагает, что необходимые свойства 
находятся в строке ]5ОМ, которая здесь для простоты жестко запрограмми- 
рована. Для анализа строки используется библиотека Соое Сзоп, а полу- 
ченный в результате ассоциативный массив применяется для создания эк- 
земпляра Рго]ес+. 
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Пример 8.18. Получение свойств Рго]есЕ из строки ]50М 


рг\\уаЕе Фип дефМарЕгот$0№() = © 
(з0п().Ёгом)оп<МифаБЛеМар<54г1па, Апу?>>( 
"""{ "паме": "[еагп Кол", "рглог\\у":5, "сопр\ефед" :{гие}""", 
МисаБЛеМар: :с1аз$.]а\ма) 


@ТезЕ 
Рип `сгеа{е рго]десе Тгом мар рагзед Ргом) $0 з%г1пд`() { 
уа\ ргодесе = Рго]ес{(де{МарЕгот750№(4))(// @ 
аззегеА1Д( 
{ аззегЕЕдца1.$("1еагп Ко Ап", ргодес*.пате) }, 
{ аззегЕаца1$(5, рго]есе.ргтог\\у) }, 
{ аззегЕТгие(рго)ес*. сотр\е{ед) } 


© Анализ строки ]5ОМ и извлечение из нее ассоциативного массива со 
свойствами 


@ Использование ассоциативного массива для создания экземпляра Рго3есё 
Функция Ёгот)зоп из библиотеки Сзоп принимает строку и тип, поэтому 
в КоНт можно указать обобщенный тип, как показано в примере. Получив- 


шийся В результате ассоциативный массив будет иметь верный тип для пред- 
ставления значений в роли делегата. 


8.6. СозддНИЕ СОБСТВЕННЫХ ДЕЛЕГАТОВ 


Задача 


Определить свойства в данном классе так, чтобы при обращении КНИМ ИСПОЛЬ- 
зовались методы чтения и записи из другого класса. 


Решение 


Определить свои делегаты свойств, создав класс, реализующий интерфейс Ве- 
а4Оп1уРгорег%у или ВеадИ\г\\еРгорег\у. 


Обсуждение 

Обычно свойство класса работает в паре с внутренним полем, но это не обя- 

зательно. Вместо чтения или изменения значения в поле эти операции можно 

делегировать другому объекту. Чтобы создать свой делегат свойства, необходи- 

мо реализовать функции из интерфейса Веа4Оп1уРгорег%у или Веадиг\{еРгорег\у. 
Определения этих интерфейсов показаны в, примере 8.19. 


Пример 8.19. Интерфейсы ВеадОп!уРгорегу и Кеаа\ИеРгорему 


1п{егРасе ВеаФОп1уРгорег%у<1п В, оц Т> { 
орегафог Фип де \а\ие(+Р15ВеЁ: В, ргорегфу: КРгорегфу<*>): Т 
} 


1пфегРасе Веадиг\%еРгорегфу<Ап В, Т> { 
орегафог Фип де \а\ие(+Р15ВеЁ: В, ргорегфу: КРгорегфу<*>): Т 
орегафог Кип зе \а\ие({Р15Ве{: В, ргорегфу: КРгорегфу<*>, уа\ше: Т) 
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Интересно отметить, что для создания делегата не нужно реализовывать ни 
один из этих интерфейсов. Достаточно просто определить функции де \/а\ие 
и зе \аше с показанными сигнатурами. 

В стандартной документации приводится тривиальный пример делегата, 
включающий класс с именем Бе\едате (см. пример 8.20). 


Пример 8.20. Класс Вееда{е из стандартной документации 


СТаз$ Ое\едафе { 
орегафог Фип де \а\ие({Р15Ве!: Апу?, ргорегфу: КРгорег{фу<*>): 5%гАлд { 
гефигп “51 5Веё, {РапК уоц ог де\еда па ‘${ргорегфу.пате}° фо ме!” 
} 


орегафог Фип зе \а\ие({Р15ВеР: Апу?, ргорегфу: КРгорегфу<*>, уа\ие: 54г4пд) { 
ргАпп(“5уа\ие Ваз Бееп а5519пед фо ‘${ргорег%у.паме}” 1п $1 $Ве+.”) 
} 


Чтобы задействовать этого делегата, нужно создать класс или переменную, 
делегирующую чтение/запись этому классу, а затем использовать эту перемен- 
ную, как показано в примере 8.21. 


Пример 8.21. Использование класса Ов{едате 


СТаз$ Ехамр1е { 
уаг р: 5%г4пд Бу Бе\еда*е() 
} 


Рип ма\л() { 
уа\ е = Ехапр\е() 
ргапп(е.р) 
е.р = “МЕМ” 


Этот код выведет следующее: 


Че\еда{е$.Ехатр\е@4с98385с, {ВапК уоц Рог дееда тд ‘р” {о пе! 
МЕМ Ваз Бееп а5$19пе4 фо ‘р’ 1п де\едафе$.Ехатр\е@4с98385с. 


Строго говоря, создавать свойство Класса совсем необязательно. 
Начиная с версии Ко т 1.1 также’можно делегировать локальные 
переменные. 


Стандартная библиотека включает несколько делегатов. В рецепте 8.3 пока- 
зан код функции по{Ми 1, которая создает приватный класс №*М№1\аг, как по- 
казано в примере 8.9. 

Еще одним примером может служить инструмент сборки Стае, который 
предоставляет предметно-ориентированный язык Кот ОЗГ, позволяющий 
взаимодействовать с контейнерами через делегированные свойства. В Сга@е 
есть два основных источника свойств. Один из них - набор свойств, связанных 
с самим проектом (экземпляр класса огд.дгае.ар\.Рго]ес®), и другой - допол- 
нительные свойства ех%га, которые можно использовать во всем проекте. 

Пусть есть файл сборки 6\19.9гаФе.К{5. Оба типа свойств можно создать 
и использовать, как показано в примере 8.22. 


142 


К? 


*» Делегаты в Ко{Ип 


Пример 8.22. Создание и использование свойств проекта и дополнительных свойств в Сга@е 


Кот 05Ё 

уа\ муРгорегфу: 5%г4пд Бу рго]есе о 
уа\ пумуЦаБЛеРгорегеу: 54г4пд? Бу ргодес& [2] 
уа1 пуМеиРгорегфу Бу ех{га(“Апл1а1 уа\ие”) [3] 


уа1 муо{РегМеиРгорегеу Бу ехёга { “1аху 1па\ уа\ие” } © 


о 
|2) 
|3) 


о 


Создать свойство проекта с именем пуРгорег%у 
Создать свойство, допускающее значение пи 1. 


Создать и инициализировать новое дополнительное свойство с именем 
мумемРгорег*у 


Создать свойство, инициализирующееся при первом обращении 


Свойства проекта можно установить из командной строки, используя син- 
таксис -РмуРгорегеу = уа\ие, или определить в файле ета @е.ргорегие$. Дополни- 
тельные свойства, определенные как показано в примере 8.22, также инициа- 
лизируются либо заданным аргументом, либо лямбда-выражением, которое 
вычисляется при первом обращении. 

Создать своего делегата свойства достаточно просто, но, как показывает 
остальная часть этой главы, на практике чаще используются существующие 
делегаты, либо из стандартной библиотеки, либо реализованные третьими 
сторонами, такими как Сга е. 


Глава 


Тестирование 


9.1. НАСТРОЙКА ЖИЗНЕННОГО ЦИКЛА ТЕСТОВОГО КЛАССА 


Задача 


Создавать экземпляры тестов ОФпИ 5 только для каждого класса, а не для каж- 
дой тестовой функции, как принято по умолчанию. 


Решение 


Использовать аннотацию @Тез+Тпз+апсе или установить свойство жизненного 
цикла по умолчанию в файле дипйр[а огт.ргорегиез. 


Обсуждение 


Этот рецепт, как и многие другие в данной главе, основан на публи- 
кации в блоге Филиппа Хауэра (РЫШрр Начег) под названием «ВезЕ 
РгасИсез юг Опй Тезние ш Ко Шт» (БИ рз://оге|.1у/У8200). 


В ИИ 4 по умолчанию новый экземпляр тестового класса создается для 
каждого тестового метода. Это гарантирует повторную инициализацию атри- 
бутов тестового класса, что делает сами тесты независимыми. Правда, при 
этом код инициализации выполняется для каждого теста. 

Чтобы избежать этого, в ]ауа свойства класса можно пометить как ста- 
тические (${а11с), а код инициализации поместить в статический метод, 
отмеченный аннотацией @ВегогеС1азз, который будет выполняться только 
один раз. 

В качестве примера рассмотрим тест Оп 4 для ]ауа. и. $4, показанный 
в примере 9.1. 
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Пример 9.1. Тест лпй 4 для проверки работы списков 


рус с1а$$ 211441154 Тез{$ { 
ргА\афе зас 1151<54г1п9> ${г4п9$ = © 


Аггау$ .а$11$Е( "БА $", "15", "а", "14$", "о", /54гАпд$"); 
ргАмафе [151<Тпедег> под\РТаБ1е = пеи Аггау|1${<>(); @ 


@ВеРогеСТа$$ © 
руБИ.с зас \уо19 гипВеРоге() { 

буфет. оце . рглп1п(“ВеРогеСТа$$ : 
} 


@Вегоге 
руБА.с №019 1п1 а е() { [2 
буфет. оц. рглп1п("Вегоге: " + мода е); 
под 1ае. а99(3); 
мода Ле.а99(1); 
мода Ле.а99(4); 
под Аа 1е.а99(1); 
под 1аЛе. а99(5); 


“ 


+ $1195); 


| 


@Тезе 
рус №019 +е${1() { 


ТР а 
} 


@Тезе 
рус №049 +е${2() { 


т 
} 


@Те$+ 

рус у014 {е${3() { 
Дан 

} 


@АЕсег 9 
рус уо19 РАпа$В() { 

буфет. оц . рглп1п(“АЁег: 
} 


@АРЕегСТа$$ © 
рус зас моф9 гипАЕег() { 
буфет. оц . рглп1п("АЁегСТа$$: 


“ 


+ мо РаБе); 


+ $г1п95); 


} 


Ф Выполняется один раз для всего класса 
@ Выполняется для каждого тестового метода 


Тестовый класс имеет два атрибута: .5+г1пд$ и мо аБе. Список под аБе ис- 
пользуется для демонстрации жизнённого цикла. В точке объявления атрибута 
он инициализируется как пустой список, а затем заполняется в методе 1т1- 
ЦаЦе с аннотацией @ВеРоге. Цель этого метода - показать, что первоначально 
список пуст, а затем заполняется. Второй раз содержимое списка выводится 


*. 
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в методе Е 4г15$1 с аннотацией @АЁ ег, чтобы показать, что теперь он содержит 
желаемые элементы. 

Список 5{г1п9$ тоже инициализируется вточке объявления атрибута. Но, что- 
бы инициализация не выполнялась перед вызовом каждого тестового метода, 
он отмечен как статический (5%а1с). Методьужизненного цикла @ВеРогеСТа$$ 
и @АЁтегСТаз5 используются здесь, чтобы показать ато коллекция $4г\4пд$ запол- 
няется правильно. 

Добиться того же поведения в Кот труднее, потому что в Кот нет ключе- 
вого слова {а 1с. Простейшее решение - использовать объект-компаньон, как 
показано в примере 9.2. 


Пример 9.2. Тест Шпй 4 для проверки работы списков в Кот (см. более удачное решение 
с использованием пи 5) 


СТа$$ 201154 5ТезЕ$ { 


сотраплоп оБЗесЕ { © 
@упбфа{1с [2 
ргА\мафе уа1 ${г1пд$ = 1А$40Е(“ЕРА$”, “15”, “а”, “115”, “о”, “$&гАп9$”) 
(@ВеРогеСТа$$ о 
@упбфа{1с [2 


Рип гипВегоге() { 
ргап п (“ВеРогеСТа$$: $5%г1п95”) 


} 
@АРхегСТа$$ © 
@упбфа{ Ас [2 


Рип гипАЁег() { 
ргап п (“АРегС1а$$: $5%г1п95”) 
} 
} 


ргА\мафе уа\ мод\РлаБДе = Аггау!11$4<Тп{>() 


(@Вегоге 
Рип 11а 7е() { 
рглп п(“Веоге: $тод\РлаБДе”) 
под Та Те. а99(3) 
моча Ле.а99(1) 
мода 1е.а99(4) 
мода 1е.а99(1) 
под 1аЛе. а99(5) 


} 


@Те$+ 

Рип (е$41() { 
ая 

} 


@Те$+ 

Рип (е$42() { 
ДИ вк 

} 
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@Те$+ 

Рип $е${3() { 
И 

} 


@АЁЕХег 
Рип Р4п1$8() { 

ргп л(“АЁег: Змод\ Рае”) 
} 


Ф® Длявыполнения операций один раз при создании экземпляра класса ис- 
пользуется объект-компаньон 


@ Добавляет модификатор з+а1с в сгенерированный байт-код ]ауа 


Объект-компаньон используется, чтобы гарантировать, что коллекция 
$+г1пд5 будет создаваться и заполняться только один раз. Методы @ВегогеС\а$$ 
и @АЁеегСТа5$ используются внутри объекта-компаньона с той же целью. Обра- 
тите внимание, что если бы инициализация списка $1г1пд$ выполнялась в ме- 
тоде 1 а те, то его следовало бы объявить с модификатором Тафе1 п, при- 
чем как маг, а не уа\|: 

СТа$$ 2011445 ТезЕ$ { 
сотрап1лоп оБЗесЕ { 


@мпбфа{1с 
рг\\уаЕе Тафелп1Е маг ${г1пд$ 


(@ВеРогеСТа$$ 
@упба1с 
Рип гипВегоге() { 
$4г1п9$ = ТА$ЕОЕ(“ЕНА5”, “15”, “а”, “А 5Е”, “о”, “5гАп9д5”) 
} 


ая 


В случаях, когда это действительно необходимо (например, при тестирова- 
нии более сложного объекта, чем простой список, требующего дополнитель- 
ной настройки), использование уаг делает код назКо т еще менее идиома- 
тическим. 

К счастью, ФпИ 5 предлагает более простое/решение. Фи 5 позволяет 
управлять жизненным циклом самого тестового класса, предлагая аннотацию 
@Тез+Тп{апсе. В примере 9.3 показана более удачная реализация тестов списков. 


Пример 9.3. Тест пи 5 для проверки работы списков в Ко{Ип (предпочтительный вариант) 


1троге огд. ип. )ир\ег.ар\.* 
1троге огд. и п1*. )лир\{ег.ар\.АззегЕ1оп$.аззегЕЕаца1$ 


@Тез+Тп${апсе(ТезТпапсе.11Ресус1е.РЕВ_СЕА$5) © 
СТа$$ ЗИ 55 Те$1$ { 
ргАмафе уа\ $%г4пд$ = @ 


АУЕОЕ( "ЕВА $", "15", "а", "ДА$е", "оф", "5&гАпд5") 


ргА\мае Тафе4фп1Е уаг модАРаБДе : Мика Ле! ${<1пе> ® 
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(@ВеРогеЕасН 

Рип зеИр() { 
моча е = мифаБЛег1$40{(3, 1, 4, 1, 5) [3 
рглп1лп( "ВеФоге: З$тод\РаБЛе") 

} 

@АЁХегЕасН 


Рип РАлл$В() { 
ргп п (“АЁег: Змод\ Рае”) 
} 


@Те$& 
Рип (е$41() { 


Иа 
} 


@Те$+ 
Рип (е${2() { 


ДИ 
} 


@Те$+ 
Рип $е${3() { 


к 
} 


© Для всех тестов создается единственный экземпляр тестового класса 
@ Создается и заполняется только один раз 
© Повторная инициализация выполняется перед каждым тестом 


Это гораздо более идиоматичный код. Если установить жизненный цикл 
РЕВ_СЁА$, то будет создаваться только один экземпляр тестового класса, не- 
зависимо от количества тестовых методов. Это означает, что атрибут $1г4пд$ 
можно создать и заполнить как обычно используя модификатор уа\. 

Сложность все еще возникает, если атрибут необходимо повторно инициа- 
лизировать перед каждым тестом. Для этогоукак показано в примере тестово- 
го класса, все еще можно использовать методы @ВеРогеЕасН и @АЁР\егЕасй, правда, 
сам атрибут должен быть объявлен с модификаторами Та%е\1п\ и уаг. Однако 
это особенность данного конкретного класса, потому что для создания и за- 
полнения списка мы используем функцию пибаЛем$+. Для более сложных 
(и более интересных) объектов можно создавать их экземпляры, а затем ис- 
пользовать метод арр\у для их настройки, как показано в следующем рецепте. 

ЛОпи 5 позволяет установить жизненный цикл теста для всех тестов в фай- 
ле свойств, чтобы избавиться от необходимости повторять аннотацию @Тез- 
{Тп5фапсе в каждом тесте. Если создать файл с именем диий-р!айогт.ргорегНе; 
в пути к классам (обычно в папке $тс/Ёез/тезоигсе$), то достаточно добавить 
в него одну строку, показанную в примере 9.4. 


Пример 9.4. Настройка жизненного цикла для всех тестов в проекте 
Эуп Е. )ур\ ег .е${Ап${апсе. \Ресус\е.деРац\* = рег_с1а$$ 
Единственный недостаток - тот, кто будет читать тестовый класс, должен 


не забыть заглянуть в этот файл, потому что по умолчанию Оп 5 все так же 
создает экземпляр класса для каждой тестовой функции. 
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9.2. Использовдниг клла‹ссов,д‚„аННЫХ В ТЕСТАХ 


Задача 
Проверить несколько свойств объекта, не раздувая код. 


Решение 
Создать класс данных, включающий все необходимые свойства. 


Обсуждение 


Классы данных в Кош автоматически получают методы едиа\$, фо5&гАпд, Ва$в- 
Соде, сору и сотропеп*М. Это делает их идеальным средством упаковки свойств 
для тестов. 

Допустим, у нас есть служба, которая возвращает информацию о книгах по 
номерам [5ВМ. Класс Воок - это класс данных, определение которого показано 
в примере 9.5. 


Пример 9.5. Класс данных Воок 


Чака с\а$$ ВооК( 
уа\ 15Бп: 5гАпд, 
уа1 {11е: 5г1лд, 
уа1 ацЁВог: 5%гАпд, 
уа1 ру 1 $Нед: [Госа\Оа&е 


Возьмем для примера конкретную книгу и протестируем ее вручную, про- 
верив все свойства, как показано в примере 9.6. 


Пример 9.6. Тестирование свойств книги вручную (утомительно) 


@Тез& 
1пЕегпа1 Фип `{е${ Боок {Ве ВагФ мау`() { 
уа\ Боок = зег\4се. Е1п4ВооКВу19 (“1935182943”) 
аззег{ТВа{(Боок.1$Бп, `15`(“1935182943”)) 
аззег{ТВа{ (Боск. 1 1е, `15`(“МаК\пд Зауа Сгооуу”)) 
аззегЕТВа{(Боок.ац Вог, `1$`(“Кеп Коузеп”)) 
аззег{ТВа{ (Боск .ри 1 $ВеЧ, `15`(1оса\Оа{е.о# (2013, МопЕВ.ЗЕРТЕМВЕВ, 30))) 


Однако такой подход требует явно писать инструкции проверки всех 
свойств. Другая проблема заключается в том, что если первая инструкция по- 
терпит неудачу, это приведет к сбою всего теста, поэтому некоторые свойства 
могут остаться непроверенными. К счастью, в ФИ 5 был добавлен метод аз- 
зег-АЦ, который принимает список аргументов переменной длины (\уагагд) 
с экземплярами ЕхесифаЛе, где ЕхесикаДе - это функциональный интерфейс, 
который не принимает никаких аргументов и ничего не возвращает. Преиму- 
щество функции аззег{А\1 заключается в том, что она выполнит все экземпля- 
ры ЕхесифаЛе, даже если какие-то из них потерпят неудачу. 

В примере 9.7 показана измененная версияттредыдущего теста, использую- 
щая эту новую возможность. 


х. 
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Пример 9.7. Использование аз5е АЦ из пи 5 для тестирования всех свойств 


@Тез+ 
Рип `и5е 2914 5 аззег%А`() { 
уа\ БоокК = ег\у\се. Е1п4ВооКВу19 (“1935182943”) 
аззегЕ АД (“сНеск а. ргорег{\е$ оЁ а БооК”, 
{ аззегЕТВа*(Боок.156п, `1$`(“1935182943”)) }, 
{ аззегЕТра*(Боок. {1Ее, `1$`(“МаКАпд Зама Сгооуу”)) }, 
{ аззегЕТНае(БооК.аиВог, `1$`(“Кеп Коизеп”)) }, 
{ аззегЕТВае(Боок.ри 1 $Вед, 
`15`(Госаа*е.о{ (2013, МопЕН.5ЕРТЕМВЕК, 30))) }) 
} 

Обратите внимание на использование лямбда-выражений для представ- 
ления экземпляров Ехесиае. Все лямбда-выражения в этом примере схожи 
в том, что ни одно из них не имеет аргументов, а используемая функция а$5- 
зегЕТВа{ возвращает \014. 

И все равно пришлось написать отдельные тесты для всех СВОЙСТВ, и это раз- 
дражает. Поскольку классы данных в Кот уже имеют правильно реализован- 
ный метод еаца\$, этот процесс можно упростить, как показано в примере 9.8. 


Пример 9.8. Использование класса данных Воок для тестирования 


@Тез+ 
1п{егпа1 Фип `изе дафа с1а$$`() { 
уа\ БоокК = ег\у4се. Е1п9ВооКВу19(“"1935182943”) 
уа\ ехрес{еф = Воок(1$Бп = “1935182943”, 
{Це = “МаК\пд За\уа Сгоому”, 
аи{Ког = “Кеп Коузеп”, 
ру 1 $Вед = 1оса\а*е.о# (2013, МопЕН.ЗЕРТЕМВЕВ, 30)) 


аззег{ТРа{(БооК, `1$`(ехресфед)) ® 


о Единственная инструкция проверки выполняет всю работу 


Теперь инструкция проверки использует метод едиа1$ класса данных. 
Для тестирования коллекции экземпляров можно использовать методы 
сравнения из библиотеки Натсгез{, как показано в примере 9.9. 


Пример 9.9. Тестирование коллекции книг 


@Тез+ 
1п{егпа1 Фип `сВеск а е|\емепф$ 1п 11$4`() { 
уа\ Роуп@ = зегу\се. РАпдАВооК$ВУТ9( 
“1935182943”, “1491947020”, "149497317Х”) 


уа1 ехресфеЧ = аггауо{( 
Воок(“1935182943”, “МаКАпд Зама Сгооуу”, 
“Кеп Коузеп”, [оса\Ба{е.рагзе(“2013-09-30”)), 
Воок(“1491947020”, “СгаФе Вес\рез Рог Апдго\9”, 
“Кеп Коузеп”, [оса\Оа{е.рагзе(“2016-06-17”)), 
Воок(“149197317Х”, “Модегп Зауа Вес\рез”, 
“Кеп Коузеп”, [оса\Ба{е.рагзе(“2017-08-26”))) 


аззег{ТВа{(Коцп@, аггауСопа\п\пд9ТпАпуОгдег (*ехрес{ед)) 
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Метод аггауСопфа1пАпдТпАпу0гдег из библиотеки Натсгез( принимает список 
аргументов переменной длины, поэтому в этом примере используется опе- 
ратор распаковывания массива, *ехрес*е4д, для разделения массива на отдель- 
ные записи. 


9.3. Использование ВСПОМОГАТЕЛЬНЫХ ФУНКЦИЙ 
С АРГУМЕНТАМИ ПО УМОЛЧАНИЮ 


Задача 
Быстро создать тестовые объекты. 


Решение 


Написать вспомогательную функцию с аргументами по умолчанию и исполь- 
зовать ее вместо сору или конструктора с аргументами по умолчанию. 


Обсуждение 


Создание тестовых объектов иногда может оказаться утомительным занятием. 
Кош позволяет указывать значения по умолчанию для аргументов в основ- 
ном конструкторе класса, но иногда очевидные значения отсутствуют. Напри- 
мер, рассмотрим класс Воок, показанный в примере 9.5, определение которого 
повторяется ниже для справки: 


Чака с1а$$ ВооК( 
уа\ 15Бп: 5гАпд, 
уа\ {11е: 5г1лд, 
уа1 ацЁРог: 5%гАпд, 
уа1 ру 1 $Нед: Госа\Оа&е 


Вместо того чтобы изменять класс и добавлять значения по умолчанию для 
всех аргументов, достаточно добавить фабричную функцию с аргументами по 
умолчанию, как показано в примере 9.10. 


Пример 9.10. Фабричная функция для создания экземпляров Воок 


ип сгеафеВоок( 

156п: $4гАп9 = “149197317Х”, 

(Це: 5%г1п9 = “Модегп Зама Вес\рез”, 

аиВог: 54г4пд = “Кеп Коизеп”, 

ру. 5Вед: [оса\Оа{е = [оса\а*е.рагзе(“2017-08-26”) 
) = Воок(1$Бп, «А е, аи Вог, рул $Вед) 


В примере 9.11 показано, как пользоваться этой функцией. 


Пример 9.11. Создание экземпляра книги с помощью фабричной функции 


уа1 подегп_)ауа_гес1фре$ = сгеафеВоокК() © 
уа\ паК\пд_)ауа_дгооуу = сгеафеВоок(1$6п = “1935182943”, @ 
(Це = "МаК4пд Зауа Сгоому", 
ру $Вед = 1оса\а{е .рагзе("2013-09-30")) 
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© Все атрибуты получат значения по умолчанию, определяемые фабрич- 
ной функцией 


@ Другая книга того же автора 


Аргументы по умолчанию используются только для создания тестовых дан- 
ных, поэтому нет необходимости добавлять их в предметный класс. 

В принципе, то же самое можно сделать с помощью функции сору, кото- 
рая автоматически создается для классов данных, но при обширном исполь- 
зовании сору код будет трудно читать, особенно во вложенных структурах. 
Фабричная функция в примере 9.12 показывает простоту функционального 
подхода. 


Пример 9.12. Класс книг, написанных несколькими авторами, и его использование 


Чака с1а$$ Ми ЕААцЕВогВоок( 
уа\ 15Бп: 5гАлд, 
уа\ {11е: 5Ег1лд, 
уа1 ацЕВог$: [15%<54г1п9>, 
уа1 ру 1 $Нед: [Госа\Оа&е 


Рип сгеафеМи\АиВогВоокК( 
15$6п: 54гАпд = “9781617293290”, 
(Це: 54г4лд = “КобАл Ап АсТоп”, 
аи{Пог$: [15{<5%г1п9> = А 50Е(“О\и гу Эегетоу”, 
“оуе Тапа Такома”), 
ру $Вед: [оса\Оафе = [оса\а*е.раг$е(“2017-08-26”) 
) = Му АдивогВоок(1$Бп, Ее, ацРог$, ри 1 $Вед) 


уа1. Ко{1Ап_1п_ас оп = сгеаеМи{ААиРогВоок() 


Если все фабричные функции поместить в служебный класс верхнего уров- 
ня, их можно повторно использовать в тестах. 


9.4. ПовторЕНИЕ ТЕСТОВ ДМмт 57СРАЗНЫМИ ДАННЫМИ 


Задача 
Выполнить тест Опй 5 с другим набором данных. 


Решение 
Использовать параметризованные и динамические тесты УИ 5. 


Обсуждение 


Пусть требуется протестировать функцию с разными наборами данных. В ОпИ 
5 для этой цели можно использовать параметризованные тесты, которые по- 
зволяют указать источник этих данных, включая значения, разделенные за- 
пятыми (Сотта-Зерага{еа Уачез, С5У), и фабричные методы. Несмотря на то 
что Лик является библиотекой ]ауа, тесты можно писать и использовать для 
тестирования кода на Ко (как в большей части этой книги). 
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Рассмотрим функцию, которая вычисляет числа Фибоначчи, реализованную 
с использованием алгоритма хвостовой рекурсии (пример 9.13). 


Хвостовая рекурсия обсуждается в рецепте 4.3. 


Пример 9.13. Рекурсивная функция для вычисления п-го числа Фибоначчи 


@)утО\ег\оа4$ 
фа гес Фип РАБопасс\(п: Тпё, а: Тпё = 0, Б: ТпЕ = 1): ТП = 
ибеп (п) { 
0 ->а 
1->Ь 
е15е -> ЕАБопасс\ (пт - 1, Б, а+ЪБ) 


} 


Число Фибоначчи определяется как сумма двух предыдущих чисел Фибо- 
наччи, причем ЕАБопасс\(0) == 0 и Е\опасс\(1) == 110. Числа образуют последо- 
вательность: 1, 1,2, 3, 5, 8, 11 ит. д. 

Давайте проверим, так ли это. В примере 9.14 показан явный тест, который 
просто вызывает несколько\раз. 


Пример 9.14. Явный вызов функции ЯБопасс! 


@ТезЕ 
Рип `РАБопасс® питбег$ (ехр11с1*)`() { 
аззег%А\Д ( 
{ аззегЕТВа*(РАБопасс1(4), `1$`(3)) }, 
{ аззегЕТНаЕ(РАБопасс1(9), `1$`(34)) }, 
{ аззегЕТНа*(РАБопасс1(2000), `1$`(1392522469)) } 


В ай 5 определена функция аззег{АЦ, гарантирующая выполнение всех 
тестов, даже если некоторые из них потерпят неудачу. Этот тест можно также 
оформить как параметризованный, использующий источник данных в форма- 
те С$У, как показано в примере-9,15. 


Пример 9.15. Использование данных в-формате С5У для параметризованного теста 


(@Рагатефег1тедТез+ 

@Сзубоигсе(«1, 1», «2, 1», «3, 2», 
«4, З», «5, 5», «б, В», «Т, 13», 
«8, 21», «9, 34», «10, 55») 

Рип `РАг$Е 10 РАБопасс\ пимбегз (с5\)`(п: Тпё, РАБ: Тп®) = 
аззег{ТВа{ (РАБопасс\(п), `1$`(Р1Ь)) 


Аннотация @С5убоигсе принимает аргумент со списком строк, которые яв- 
ляются входными данными для функции. Каждая строка содержит все необ- 
ходимые аргументы, разделенные запятыми. В этом примере проверяются 
первые 10 чисел Фибоначчи, и результат выглядит следующим образом: 


0 Есть такая шутка: конференция Фибоначчи в этом году будет не хуже, чем в двух 
предыдущих вместе взятых! 
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а, 1 Иг$Е 10 РАБопасс\ пимег$ (с5\)(1п&, 4п)[1] 05 раззед 
[2] 2, 1 Иг$Е 10 РАБопасс\ пимег$ (с$\)(1п&, 4п)[2] 05 раззед 
[3] 3, 2 Иг$Е 10 РАБопасс\ пимег$ (с$\)(1п&, 1п)[3] 05$ разед 
[4] 4, 3 Иг$Е 10 РАБопасс\ (пимфег$ (с$\)(1п&, 14п)[4] 05 раззед 
[5] 5, 5 Иг$Е 10 РАБопасс\ пимбег$ (с5\)(1п&, 1п)[5] 05 раззед 
[6] 6, 8 Иг$Е 10 РАБопасс\ лимбег$ (сз\)(1пЕ, 11Е)[6] 05$ ра$$ед 
[7] 7, 13 Иг$Е 10 РАБопасс\“питбег$ (сз\)(1п&, 14п1)[7] 05 раззед 
[8] 8, 21 Иг$Е 10 РАБопасс\ пимБег$ (с$\)(1п&, 1п)[8] 0$ раззед 
[9] 9, 34 Иг$Е 10 РАБопасс\ пимег$ (с$\)(1п&, 14п)[9] 05$ раззед 
[10] 10, 55 Иг$Е 10 РАБопасс\ пимег$ (с$\)(1п&, 1п)[10] 05 раззед 


Также для генерирования тестовых данных в ий 5 можно использовать фаб- 
ричные методы. В ]ауа фабричный метод втестовом классе должен бытьобъявлен 
статическим (51а), если тест не снабжен аннотацией @Те${Тпз+апсе(1\Ресу<1е. 
РЕК_С1А55), аесли он определен во внешнем классе, то всегда должен объявляться 
статическим. Еще он не может принимать никаких аргументов. Наконец, воз- 
вращаемое значение должно иметь тип, поддерживающий итерации, например 
быть потоком, коллекцией, итератором, итерируемым объектом или массивом. 

Если выбрать жизненный цикл 1Аесус\е.РЕВ_С1А5$, как в предыдущих ре- 
цептах в этой главе, то можно просто добавить функцию для создания данных 
и ссылаться на нее с помощью @Ме{Ко45оигсе, как показано в примере 9.16. 


Пример 9.16. Доступ к функции экземпляра как к источнику параметров 


рг\\афе Рип РАБпимЬег$() = 115401( 
АгдутепЕ$.0+(1, 1), Агдитепе$.0#(2, 1), 
Агдцтеп{$.0{(3, 2), АгдитепЕ$.о{(4, 3), 
Агдутеп{$.01(5, 5), АгдимепЕ$.о{(6, 8), 
Агдцтеп{$.0{(7, 13), Агдитепе$.о+(8, 21), 
Агаоцтеп{$.0{(9, 34), АгдитепЕ$.о#(10, 55)) 


(@Рагатефег1тедТез*(пате = “Ё\Бопасс1({0}) == {1}”) 

@Метпо45оигсе(“РАБпитЬег$”) 

Рип `РАгзе 10 РАБопасс\ питбег$ (1п$фапсе ме ро9)`(п: Тпе, РАБ: Тпё) = 
аззегЕТВа{ (ЕАБопасс\(п), `1$`(Е1Ь)) 


В Хай имеется класс Агдитеп{$ с фабричным методом оф, объединяющим оба 
входных аргумента. Он возвращает список 115*<Агдитеп{$>, каждый элемент ко- 
торого содержит два входных аргумента для тестового метода. 

Если выбрать жизненный цикл по умолчанию [Ресус1е.РЕВ_МЕТНОО, то функ- 
цию следует поместить в объект-компаньон, как показано в примере 9.17. 


Пример 9.17. Использование объекта-компаньона для хранения функции, возвращающей 
параметры 


сотраплоп оБесЕ { 

[/ это необходимо, если для параметризованного теста 

// выбран жизненный цикл [\Ресус1е.РЕВ_МЕТНОО 

@мпбфаЕс © 

Рип 115$() = 115%01( 
Агдутепе$.0#(1, 1), Агдитепе$ .0#(2,/41), 
Агдутепе$.о{т(3, 2), Агдимепе$.о{(4, 3), 
Агдутепе$.о1(5, 5), АгдимепЕ$.о{(6, 8), 
Агдутепе$.о{т(7, 13), АгдимепЕ$.о{(8, 21), 
Агдутепе$.о{(9, 34), АгдитепЕ$.0#(10, 55)) 
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(@Рагаме{ег1теЧТез*(паме = “Ё4Бопасс1({0}) == {1}”) 
@Метпо45оигсе(“ +15”) 
Рип `РАг$Е 10 ЕАБопасс\ пимбегз (сотрапфоп меВод)`(п: Тпё, РАБ: ТпЕ) = 
аззегЕТВа{ (ЕАБопасс\(п), `1$`(Е1Ь)) 
© Эта аннотация необходима, чтобы библиотека Фи (]ауа) видела функ- 
цию как статическую 


Единственная странность - необходимость использования аннотации 
@) утка с, чтобы библиотека ] Оп на ]ауа Видела метод-источник как ста- 
тический метод. 

Наконец, обратите внимание, что аннотация. @Рагаметег\те4Тез+ принимает 
строковый аргумент, который позволяет вам форматировать вывод результатов 
тестирования. Результат для любого набора будет выглядеть, как показано ниже: 


ЕАБопасс1(1) == 1 ИАг$Е 10 РАБопасс\ пимбегз (теВо9)(4пЕ, 11е)[1] 
ЕАБопасс1(2) == 1 ИАг$Е 10 РАБопасс\ питбег$ (теВо9)(4пЕ, 11е)[2] 
Е АБопасс1 (3) == 2 ИАг$Е 10 РАБопасс\ пимбегз (тево9)(4пЕ, 11е)[3] 
Е \Бопасс1(4) == 3 ИАг$Е 10 РАБопасс\ пимбегз (тево9)(4пЕ, 11е)[4] 
ЕАБопасс1(5) == 5 ИАг$Е 10 РАБопасс\ пимбег$ (тефВо9)(4пЕ, 11е)[5] 


ЕАБопасс1(6) == 8 ИАг$Е 10 РАБопасс\ пимбегз (теВо9)(4пЕ, 1пе)[6] 
Е АБопасс1(7) == 13 ИАг$Е 10 РАБопасс\ пимбегз (теВо9)(4пЕ, 11е)[7] 
Е \Бопасс1(8) == 21 ИАг$Е 10 РАБопасс\ питБегз (теВо9)(4пЕ, 118)[8] 
Е АБопасс1(9) == 34 ИАг$Е 10 РАБопасс\ пимБегз (те Во9)(4пЕ, 11е)[9] 
Е \Бопасс1(10) == 55 ИАг$Е 10 РАБопасс\ пимбегз (теВо9)(1пЕ, 1пе)[10] 


Смотри также 


Рецепт 9.5, где показано, как использовать классы данных для конструирова- 
ния еще более сложных наборов исходных данных. 


9.5. Использование классов даННЫХ 
ДЛЯ ПАРАМЕТРИЗАЦИИ ТЕСТОВ 


Задача 
Получить легко читаемый вывод параметризованного теста. 


Решение 


Создать класс данных, объединяющий входные и ожидаемые значения, и ис- 
пользовать функцию в качестве метода-источника для генерирования тесто- 
вых данных. 


Обсуждение 


Как мы уже знаем, ФИ 5 поддерживает параметризованные тесты, которые 
получают данные для тестирования из метода или файла, и каждый набор дан- 
ных проверяется с помощью одного и того же теста. Параметризованные тесты 
подробно рассматривались в рецепте 9.4. Однако все тесты в примерах своди- 
лись к сравнению обрабатываемого значения с ожидаемым. 

Рассмотрим функцию Е Бопасс\ из примера 9.15, определение которой при- 
водится ниже для простоты: 
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@)утО\ег\оа4$ 
фа гес Фип РАБопасс\(п: Тпё, а: Тпё = 0, Б: ТпЕ = 1): ТП = 
мбеп (п) { 
0 ->а 
1->Ь 
е15е -> ЕАБопасс\(п - 1, Б, а+Ъ) 


} 


Дополнительные параметры аи Ь в этой функции предназначены для реали- 
зации хвостовой рекурсии и имеют соответствующие значения по умолчанию. 
То есть эта функция обычно вызывается с одним целым числом и возвращает 
целое число. 

Теперь определим класс данных для хранения входных и ожидаемых выход- 
ных данных, как показано в примере 9.18. 


Пример 9.18. Класс данных для хранения входных и ожидаемых выходных данных 


Чафа с1а$$ ЕАБбопасс\Те${Ба{а(\а1. пимБег: Тпё, \уа1 ехресфед: Тпе) 


Поскольку классы данных в Кот уже имеют метод {051г1пд, можно создать 
тестовый метод для параметризованных тестов, который создает экземпляр 
класса данных для каждой пары входных и выходных данных, как показано 
в примере 9.19. 


Пример 9.19. Параметризованный тест, использующий класс данных 


(@Рагатефег1тедТез+ 

@Метвпо45оигсе («Р\Бопасс\Тез{Ва{а») 

Рип `среск РАБопасс\ и$1пд дафа с1а$$`(Чафа: ЕАБопасс\Те${Бафа) { 
аззег{ТВа{(Р\Бопасс\ (дафа.питБег), `1$`(дафа.ехресфед)) 


} 


рг\\уаЕе Кип Е\Бопасс\Тез{Бафа() = 5{геат.о+( 
РАБопасс\Тез{Бафа(питбег = 1, ехресфе4 = 1), 
РАБопасс\Те${Бафа(пимЬег = 2, ехресфед = 1), 
РАБопасс\Тез{Бафа(питбег = 3, ехрес{е4 = 2), 
РАБопасс\Тез{Бафа(питбег = 4, ехрес{е4 = 3), 
РАБопасс\Тез{Бафа(питбег = 5, ехрес{е4 = 5), 
РАБопасс\Тез{Бафа(питбег = 6, ехрес{е4 = 8), 
РАБопасс\Тез{Бафа(питбег = 7, ехрес{е4 = 13) 


Для тестов Фпй, использующих метод-источник, функция должна 
быть статической (для ]ауа), если выбран жизненный цикл, отлич- 
ный от Те${Тп+апсе .11Ресус1е.РЕВ_С1А$5. В противном случае приват- 
ную функцию следует поместить в объект-компаньон и отметить ее 
аннотацией @3утб{а с (подробности см. в рецепте 9.1). 


Этот тест выведет следующие результаты: 


сНеск Е\Бопасс\ и$1пд дафа с1а$$(Е\Бопасс\Те{Вата) 
[1] РАБопасс\ТезБафа(пимЬег=1, ехрес{ед=1) 
[2] РАБопасс\Тезбафа(пимЬег=2, ехрес{ед=1) 
[3] РАБопасс\ТезБафа(пимЬег=3, ехресед=2) 
[4] РАБопасс\ТезБафа(пимЬег=4, ехресед=3) 
[5] РАБопасс\ТезБафа(пимЬег=5, ехресфед=5) 
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[6] РАБопасс\ТезБафа(пимЬег=б, ехресфед=8) 
[7] РАБопасс\ТезБафа(пимЬег=7, ехресед=13) 


Класс данных Е\бопасс\Тез{Оа{а автоматически получает метод +о5+г\пд, кото- 
рый позволяет выводить результаты в удобочитаемом виде. 


Смотри также 
Рецепт 9.4, где описывается использование параметризованных тестов, по- 
явившихся в ПИ 5. 


пав 1.0 


Ввод и вывод 


Операции ввода и вывода реализуются-в Кот легко и просто, но их стиль от- 
личается от привычного для разработчика на ]ауа. Ресурсы в Кот часто за- 
крываются с помощью функции изе, которая делает это от имени пользователя. 
В этой главе представлено несколько рецептов, описывающих данный подход 
на примере файлов, но их можно распространить и на другие ресурсы. 


10.1. УпРАВЛЕНИЕ РЕСУРСАМИ С ПОМОЩЬЮ И5Е 


Задача 


Обработать ресурс, такой как файл, и гарантировать его закрытие по оконча- 
нии операций с ним, несмотря на то что Кош не поддерживает конструкцию 
(ту-м-гезоигсез. 


Решение 
Использовать функцию-расширение изе или изе пез. 


Обсуждение 


В ]аха 1.7 появилась конструкция {гу-м/И-гезоигсез, которая позволяет откры- 
вать ресурс, указанный викруглых скобках между ключевым словом *гу и со- 
ответствующим ему блоком; ]УМ автоматически закроет ресурс после выпол- 
нения блока гу. Единственное требование - чтобы ресурс был представлен 
классом, реализующим интерфейс С1озеаТе. Этот интерфейс реализуют такие 
классы, как ЕЦе, 5%геам и многие другие, как показано в примере 10.1. 


Пример 10.1. Использование конструкции 1гу-\ИЙ-гезочцгсе$ в ]ауа 


раскаде 10; 


1трогЕ )ауа.1о.*; 

1трогЕ )ауа. пло. Ре. ЕАДе$; 
1трогЕ )а\уа. пло. РДе.Ра{В$; 
1трогЕ )а\уа. и. 5Егеам. ${геап; 


руБ\Ас с1а$$ Тгум\НВезоигсе$Вемто { 
руб 1с зас у0%4 ма1п(5$г1па[] агд$) ЕВгомз$ ТОЕхсер оп { 
54г4пд рафН = “згс/ма\1п/гезоигсе$ /БооК_Чафа.с$\”; 
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ЕЦе РЦе = пем ЕДе(ра В); 
гла ле = пи 1; 
+гу (ВиРРегедВеадег геадег = пеи Ви РегедВеадег(пеи РДеВеадег(РЦДе))) { ® 
ие ((11пе = геадег .геа91лпе()) != пи ТТ) { 
бу${ет. це. рглп1п(1А ле); 


} 

} 

{гу (5{геам<5г1п9> Алпе$ = РЦе$. Апез(Ра{Н$ .дее(ра{В))) { [2 
1пез .РогЕасв(5уз%ем. оц: :рглп п); 

} 


© виЁГегедВеадег реализует интерфейс С1озеаЛе 
@ 5{геап реализует интерфейс СТозеаЛе 


Класс Ви РегеЧВеадег и интерфейс 5*геам оба реализуют интерфейс СТозеаЛе, 
соответственно, оба имеют метод с1озе, который автоматически вызывается 
по завершении блока «гу. 

Вот некоторые интересные особенности, которые стоит отметить: 


О в]ауа 10 и выше объявление Ви РегедВеадег и 5геамп можно заменить за- 
резервированным словом уаг. Фактически это один из основных при- 
емов автоматического определения типа локальной переменной. Здесь 
он не используется, чтобы избежать путаницы с ключевым словом уаг 
в Кот; 

О в]ауа 9 и выше больше не нужно создавать переменную С1о5еаЛе внутри 
круглых скобок. Ее можно передать извве. И снова этот прием не исполь- 
зуется здесь; 

О поскольку сигнатура метода па1п изменилась и теперь предусматрива- 
ет возбуждение исключения ТОЕхсер оп, мы столкнулись с одним из тех 
редких случаев использования блока {гу без сатс! или АлаЦ\у. 


Это все хорошо, но, к сожалению, конструкция {ту-м®-гезоигсез не поддер- 
живается в Кот. Зато Кот добавил функции-расширения ицзе для СозеаБ1е 
и ч5е Ллез для Веадег и Ее. 

Вот как выглядит сигнатура че пез: 

Але Фип <Т> РЦе.изелпез( 
сНагзе{: СПагзее = СВагзе{$.ИТЕ_8, 
Ыоск: (бедиепсе<5г\пд>) -> Т 

): т 

Первый и необязательный аргумент - это используемый набор символов, по 
умолчанию ОТЕ-8. Второй аргумент - лямбда-выражение, отображающее после- 
довательность 5едиепсе строк из файла в обобщенный аргумент Т. Функция иве- 
Илез автоматически закрывает средство чтения после завершения обработки. 

Например, в системах Ох, основанных на В5О (включая тасО5), имеется 
файл, содержащий все слова из международного словаря Вебстера, который 
не защищен авторскими правами. В Мас 0$ этот файл находится в каталоге 
/изг/зпаге/@сИмюога$ и содержит 238 000 слов, по одному в строке. Код в при- 
мере 10.2 возвращает 10 самых длинных слов в этом словаре. 
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Пример 10.2. Поиск 10 самых длинных слов в словаре 


Рип 9е41101опдезИог9$Тп0\АсТопагу() = 
ЕЦе(“/изг/зВаге/44с{/мог45”) .изе!Апез { ТАпе -> 
1ле. Рег { 1&.1епдВ > 20 } 
„зог(еЧВу)езсеп\Алпд(${г\лпд: : 1епдЕП) 
.КаКе(10) 
6011$) 
} 


Функция отфильтровывает все строки короче 20 символов (то есть все слова 
короче 20 символов, потому что каждая строка содержит одно слово), сортирует 
их по длине в порядке убывания, выбирает первые 10 и возвращает в виде списка. 

Вот как можно вызвать эту функцию: 


9еЕ101опде${Мог4$Тп0\с\опагу().РогЕасй { могЧ -> 
ргАп1п(«$мог@ (${мога.1епаВ})») 


Она выведет следующие строки: 


Тогта\дебудезирроху1а%е (24) 
раНо1о9\сорзуспо\од\са1. (24) 
степ ЕАсорНозорН\са1. (24) 
{ефгалодоррепо\рАРа\елп (24) 
{Вугорага{Вуго\дескогтлте (24) 
апАгоротогрНо\0о91са Ду (23) 
ЫерКагозрЕ\псегесфомту (23) 
ер\9\Чутодеегепеесому (23) 
Тогма1\девудези\рпохус (23) 
даз+гоеп{егоапазото$1$ (23) 


В примере 10.5 показана реализация Ее. изе лез в стандартной библиотеке. 


Пример 10.53. Реализация функции-расширения изе пез для Е|е 


АпИле Фип <Т> Веадег .изеАлпе$( 
Ыоск: (Зедиепсе<5г\па>) -> Т): Т = 
БиРегед().изе { Боск(1+. Апебедиепсе()) } 


Обратите внимание, что реализация создает буферизованный экземпляр 
Веадег (возвращаемый функцией Би{{егед) и делегирует выполнение операции 
его функции ие. 

Сигнатура этой функции чзе показана в примере 10.4. 


Пример 10.4. Сигнатура функции-расширения изе для С1о5еаЩе 
АпИле Фип <Т : С1озеаБЛе?, В> Т.изе(БЛоск: (Т) -> В): В 


Ее реализация осложнена необходимостью обработки исключений, но суть 
ее сводится к следующему: 


гу { 
гефигп БЛоск(+ВА$) 
} сафсв (е: ТРгомаЛе) { 
// сохранить исключение для использования дальнейшем 
ЕВгом е 
} НлаЦу { 
с105е() // требует еще одного блока %гу/са%св 


} 
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Функция изе является примером шаблона проектирования Ехесие Агоипа 
Мефоад, когда инфраструктурный код находится в библиотеке, а фактическую 
работу выполняет передаваемое лямбда-выражение. Такое разделение инфра- 
структурной и прикладной логики помогает сосредоточиться натекущей задаче. 


Функция изе, применяемая в этом рецепте, определена в интерфейсе 
СТозеаЛе, доступном в ]ауа 6. Если вам использовать ]ОК, поддержи- 
вающий ]ауа 8, то в этой версии та же функция определена и в Ац\о- 
Созеае. 


Смотри также 


Рецепт 10.2, где показано, как” использовать блок чзе непосредственно. 
Рецепт 13.4, где функция чзе используется для остановки пула потоков вы- 
полнения ]ауа. 


10.2. ЗАпись в ФАЙЛ 


Задача 
Выполнить запись в файл. 


Решение 


В дополнение к обычным ]ауа-методам ввода/вывода использовать функции- 
расширения для класса ЕЦе, возвращающие потоки вывода и объекты, реали- 
зующие запись. 


Обсуждение 


В ]ауа-класс дама.1о.Ее было добавлено несколько функций-расширений. 
Выполнить итерации по строкам в файле можно с помощью функции ФогЕасйв- 
Цле. С помощью геад А пез можно получить коллекцию всех строк, имеющихся 
в файле, что может пригодиться при работе с небольшими файлами. Функция 
изе пез, описанная в рецепте 10.1, позволяет указать функцию, которая будет 
вызываться для каждой строки. Если файл достаточно мал, для чтения его со- 
держимого в строку или в массив байтов можно использовать геадТех{ или геад- 
Вуфез соответственно. 

Чтобы выполнить запись в файл с заменой всего существующего содержи- 
мого, можно использовать функцию иг еТех+, как показано в примере 10.5. 


Пример 10.5. Запись в текстовый файл с заменой его содержимого 


РД е(«ту Це. {х{»).игфеТехе(«Му дафа») 


Трудно представить что-то еще более простое. Функция иг еТех+ принима- 
ет необязательный параметр, определяющий набор символов, который имеет 
значение по умолчанию ОТЕ-8. 

Класс ЕЦе также имеет функцию-расширение аррепдТех+, которая добавляет 
данные в конец файла. 
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Функции иг\{еТех{ и аррепдТех{ делегируют выполнение операций функциям 
иг\ЕеВутез и аррепЧ9Ву{ез, каждая из которых использует функцию ие, чтобы га- 
рантировать закрытие файла после записи. 

Также можно использовать функции иг ег (или ргАпиг ег) и Би Еегедиг\ ег, 
которые, как можно догадаться, возвращают би{ри{5{геамиг\ {ег и Ви Регедиг\{ег. 
С помощью любого из этих объектов можно добавить блок изе, выполняющий 
фактическую запись, как показано в примере 10.6. 


Пример 10.6. Запись с помощью функции изе 


ЕЦ е(ЕДеМате).ргАпИгАег().изе { иг\ ег -> 
игЦег. ргАп п(дака) } 


Экземпляр Би егедигАхег с блоком ие используется аналогично. 


Смотри также 
Рецепт 10.1, где подробно обсуждаются функции изе и изе пез. 


ава 1 


Разное 


Эта глава включает рецепты, которые нельзя отнести ни к одной из предыду- 
щих тем. Здесь вы узнаете, как сделать функцию иеп исчерпывающей, как из- 
мерить время выполнения функции, как использовать функцию 1000 из стан- 
дартной библиотеки и многое другое. 


11.1. ОБРАБОТКА ВЕРСИИ Котим 


Задача 
Определить программно используемую версию Кот. 


Решение 
Использовать свойство СОВВЕМТ объекта-компаньона класса Ко 11п\ег$\оп. 


Обсуждение 


Начиная с версии 1.1 пакет Кот включает класс Ко п\ег$\оп, содержащий 
старший и младший номера версии, а также номер исправления. Его метод 
ф054г4Ап9 возвращает комбинацию в форме та/ог.ттог.расй для данного эк- 
земпляра этого класса. Текущий экземпляр класса хранится в общедоступном 
поле СУВВЕМТ объекта-компаньона. 

Учитывая вышесказанное, получить текущую версию Кот тривиально 
просто: достаточно прочитать поле Ко{11п\ег$1оп.СИВВЕМТ, как показано в при- 
мере 11.1. 


Пример 11.1. Вывод текущей версии Ко{Ип 


Рип ма\п(аг9$: Аггау<5г4пд>) = 
ргап п (“ТНе сиггепЕ Ко Ап Мег$\оп 1$ ${Ко А пМег$\1оп. СУВВЕМТ }”) 
} 


Результатом является трехкомпонентный номер версии компилятора Ко пт, 
например 1.3.41. Все три компонента являются целыми числами от 0 до МАХ_ 
СОМРОМЕМТ _\/АЦЕ, которое имеет значение 255. 
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Свойство СУВВЕМТ объявлено как общедоступное и отмечено аннота- 
цией @)умЕ1е14, поэтому оно также доступно из ]ауа. 


Класс Ко Ап\ег$Лоп реализует интерфейс Сопрагае. То есть его экземпля- 
ры можно сравнивать с помощью таких операторов, как < или >. Класс также 
реализует методы едуца1$ и ВазНСоде. Наконец, конструкторы в Ко 1п\ег$\оп по- 
зволяют указать старший и младший номера версии или старший и младший 
номера, а также номер исправления. 

В результате можно выполнить любоеиз действий, показанных в приме- 
ре 11.2. 


Пример 11.2. Сравнение версий Кот 


@ТезЕ 
Рип `сомраг1зоп оф Ко{1Ап\егз1оп 1п$фапсез могКк`() { 
уа1 \12 = Ко А п\ег$\1оп(ма)ог = 1, м лог = 2) 
уа\ \1341 = Ко Ап\ег$\1оп(1, 3, 41) 
аззег%А\Л ( 
{ аззегЕТгие(\12 < Ко п\ег$\1оп.СИВВЕМТ) }, 
{ аззегЕТгие(\1341 <= Ко Алп\ег$\оп.СУВВЕМТ) }, 
{ аззегЕЕаца\$ (Ко Алп\ег$\оп(1, 3, 41), 
Ко Ап\егзТоп(ма)ог = 1, пАпог = 3, рафсй = 41)) } 


Имеется также функция 15Аеаз*, с помощью которой можно убедиться, 
что версия Кот не ниже некоторой конкретной версии, как показано в при- 
мере 11.53. 


Пример 11.3. Сравнение версии Ко{Ип с конкретным номером 


@ТезЕ 

Рип `сиггепЕ уегз\1оп 1$ аЁ 1еазе 1_3`() { 
аззег{Тгие (Ко 11п\Мег$\оп. СУВВЕМТ .15Аеа${(та]ог = 1, м\лпог 
аззег{Тгие (Ко 1п\Мег$\оп. СУВВЕМТ .15Аеа${(та]ог = 1, м\лпог 


3)) 
3, рафсВ = 40)) 


Как видите, не составляет никакого труда проверить версию Ко 11 и напря- 
мую работать с ней. 


11.2. МногокРАТНОЕ ВЫПОЛНЕНИЕ ЛЯМБДА-ВЫРАЖЕНИЯ 


Задача 
Выполнить заданное лямбда-выражение несколько раз. 


Решение 
Использовать встроенную функцию гереа*. 


х. 
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Обсуждение 


В стандартной библиотеке имеется функция гереа{. Это встраиваемая (1п- 
Иле) функция, которая принимает два аргумента: Тп{ - количество итераций 
и функцию (1п{) -> Уп для выполнения. 

Текущая реализация представлена в примере 11.4. 


Пример 11.4. Определение функции гереа{ 


@Ко Ап. Апегпа\1 .ТпАлпебту 
руБ\Ас 11 пе Фип гереа{({1ме$: Тпё, ас&\оп: (Тпё) -> Уп) { 
сопЕгасе { са1$ТпРТасе(ас\оп) } 


Фог (1пдех 4п 0 ип Е мез) { 
ас \оп(1пдех) 
} 


Функция выполняет заданное лямбда-выражение указанное количество раз, 
передавая ему параметр с номером текущей итерации, отсчитываемым с нуля. 
В примере 11.5 показан простой случай использования этой функции. 


Пример 11.5. Использование гереа+ 


Рип ма\п(аг9$: Аггау<5%гАпд>) { 
гереа*(5) { 
ргАп п (“Соуп пд: $1”) 
} 


Этот код выведет: 


Сочп пд: 0 
Сочп пд: 1 
Сочп пд: 2 
Сочп пд: 3 
Сочп пд: 4 
Использование гереаф вместо цикла является иллюстрацией применения 
внутреннего итератора, когда фактический процесс повторения выполняется 
библиотекой. 


11.5. ИсчеРПЫВАЮЩАЯ ИНСТРУКЦИЯ М/НЕМ 


Задача 


Заставить компилятор потребовать определения исчерпывающей инструкции 
ивеп. 


Решение 


Добавить простое свойство-расширение с именем ехваиз ме к обобщенному 
типу, которое возвращает значение, и добавить его к блоку ипеп. 
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Обсуждение 


Так же как оператор 14, инструкция мпеп возвращает значение. Она действует по- 
добно оператору зи с в ]ауа, но, в отличие от него, не требует явно выходить из 
каждого варианта и объявлять внешнюю переменную, чтобы вернуть значение. 

Например, предположим, что требуется вывести остаток от деления числа 
на 5, как показано в примере 11.6. 


Пример 11.6. Вывод остатка от деления числа на 3 


Рип ргАпЕМо93(п: ТпЕ) { 
мпеп (п% 3) { 
9 -> рп лп(“ бп % 3 == 0”) 
1 -> рп т (“" п % 3 == 1”) 
2 -> рп (“ бп % 3 == 2”) 


Если выражение ипеп не возвращает значения, Кот не требует, чтобы оно 
было исчерпывающим, и это как раз тот случай, когда такое поведение удобно. 
Мы знаем, что остаток может быть равен только 0, 1 или 2, поэтому здесь на 
самом деле реализована исчерпывающая проверка, но компилятор не знает 
этого. В этом легко убедиться, преобразовав эту простую функцию в выраже- 
ние, как показано в примере 11.7. 


Пример 11.7. Использование у/Пеп для возврата значения 


Рип рг1пЕМо9351па1е5{афетеп(п: ТпЕ) = мвеп (п % 3) { 
0 -> рап лп(“ п % 3 == 0”) 
1 -> рип (“п % 3 == 1”) 
2 -> рип (“бп % 3 == 2”) 
е15е -> рп лп(“Ноч$Фоп, ие Вауе а ргоДет...”) ® 


© Не компилируется без предложения е\15е 


Компилятор требует добавить предложение е\5е в это выражение, даже при- 
том что функция рп л ничего не возвращает Наличие знака равенства озна- 
чает присваивание, а следовательно, условное выражение должно быть исчер- 
пывающим. 

Поскольку Ко т требует наличия блока е|5е в любом условном выражении, 
возврашающем значение, этим можно воспользоваться, чтобы потребовать 
сделать все блоки мпеп исчерпывающими. Для этого достаточно создать свой- 
ство-расширение с именем ехраи$ уе, как показано в примере 11.8. 


Пример 11.8. Добавление свойства ехНац$Нуе в любой объект 


уа1. <Т> Т.ехначзАме: Т 
9е*() = {1$ 


Этот код добавит свойство ехНацз ме в обобщенный тип Т с собственным ме- 
тодом чтения, который возвращает текущий объект. 

Теперь это свойство можно добавить куда угодно, включая блок ийеп, чтобы 
принудительно заставить его возвращать значение. В примере 11.9 показано, 
как это делается. 


*% 
> 
с 
| 


11.4. Использование функции гер[асе с регулярными выражениями 


Пример 11.9. Вывод остатка от деления числа на 3 (исчерпывающая версия) 


Рип ргАпЕМодЗЕхвац$м\е(п: Тп{) { 
мпеп (п% 3) { 
9 -> рами (“бп % 3 == 0”) 
1 -> рп т ("п % 3 == 1”) 
2 -> рат (“бп % 3 == 2”) 
е15е -> ргАп 1п(“Нои$Фоп, ме Науе а ргоБем...”) 
}.ехВауцз уе ® 


© С»войство заставляет компилятор потребовать добавить предложение е15е 


Свойство ехпаиз уе в конце блока ивеп возвращает текущий объект, поэтому 
компилятор Кот требует, чтобы он был исчерпывающим. 

Цель этого примера состояла в том, чтобы`потребовать от инструкции мйеп 
быть исчерпывающей, но он также является‘хорошей иллюстрацией, насколь- 
ко полезным может быть добавление простого!свойства-расигирения к уни- 
версальному типу. 


11.4. Использование хУНКЦИИ ВЕРЕАСЕ 
С РЕГУЛЯРНЫМИ ВЫРАЖЕНИЯМИ 


Задача 
Заменить все вхождения подстроки заданным значением. 


Решение 


Использовать функцию гер\асе класса/54ГАпа, которая имеет перегруженные 
версии, принимающие строку или регулярное выражение. 


Обсуждение 


Класс 5%г4пд реализует интерфейс СВаг5едиепсе, то есть на самом деле имеет две 
версии функции гер\асе, как показано в примере 11.10. 


Пример 11.10. Две перегруженные версии функции гер(асе 


Рип 5Ег1лд.герТасе( 
о14\а\ие: 54гАпд, 
пеи\а\ие: 5%г\лпд, 
19погеСазе: Воо\еап = Ка15е 
): 5Ег1л9 


Рип СПагбедиепсе. гер\асе( 
гедех: Ведех, 
гер1асетеп*: ${г1лпд 

): 5Ег1л9 


Обе версии заменяют все вхождения подстроки о\4\а\ше или совпадения с ре- 
гулярным выражением гедех указанным значением пех\/а\ие либо гер\асетеп+. 
Функция гер\асе в классе 5{г1пд принимает необязательный аргумент, признак 
чувствительности к регистру, который по умолчанию не игнорирует регистр. 
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Эти две версии функций могут вызывать путаницу, потому что пользователь 
может предположить, что первая (принимающая аргумент типа 54г4лд) будет 
обрабатывать строку, как если бы она была регулярным выражением, но на 
самом деле это не так. Тест в примере 11.11 показывает различия между двумя 
функциями. 


Пример 11.11. Использование двух перегруженных версий гер(асе 


@Тез+ 
Рип `Фетоп$гафе гер1асе и\ЕВ а $%г4пд \° гедех`() { 
аззег{А1Д ( 
{ аззегЕЕаца1$(“опе*(мо*”, “опе.{мо.”.гер\асе(“.”, “*”)) }, 
{ аззегЕЕаца1$(“********”, “опе.{мо.”.гер1асе(“.”.{оВедех(), “*”)) } 
) 
} 


В первом примере точки (сами символы) заменяются звездочкой, а во вто- 
ром точки обрабатываются как элементы регулярного выражения, то есть как 
соответствующие любому отдельному символу. В результате первый пример 
заменит звездочками только две точки, а второй - все символы. 

Фактически здесь есть две потенциальные ловушки для разработчиков на 
Таха: 


О функция герТасе заменяет все вхождения, а не только первое. В ]ауа экви- 
валентный метод называется гер1асед11; 

О перегруженная версия, принимающая строку в первом аргументе, не ин- 
терпретирует эту строку как регулярное выражение. Это тоже не похоже 
на поведение одноименного метода в ]ауа. Чтобы строка интерпретиро- 
валась как регулярное выражение, ее сначала нужно преобразовать с по- 
мощью функции фоВедех. 


Рассмотрим более интересный пример и проверим, является ли стро- 
ка палиндромом. Палиндромы - это строки, которые одинаково читаются 
слева направо и справа налево, при этом допускается игнорировать регистр 
и пунктуацию. Обратите внимание, что такую функцию можно реализо- 
вать в стиле ]ауа (Т.е. «говорить на Кот с акцентом на ]ауа»), как показано 
в примере 11.12. 


Пример 11.12. Проверка палиндромов в стиле )ауа 


Рип 15Ра1($4г1пд: 5%г4п9): Воб1еап { 
уа\ те5{5{г4пд = зЕг1пд.фоГоиегСазе() .гер1асе(“”” [\\+]””” .{оВедех(), “”) 
гефигп Те5Е5г4пд == {ез5г4пд.геуегзед() 


В таком подходе нет ничего плохого, и.он прекрасно работает. Эта функ- 
ция сначала преобразует строку в нижнийтфегистр, а затем использует вер- 
сию гер\асе, принимающую регулярное выражение, чтобы заменить все сим- 
волы, «не являющиеся символами слов»,'пустыми строками. Метасимвол \м 
в регулярном выражении представляет любой символ слова, то есть букву 
нижнего регистра а-2, букву верхнего регистра А-7, цифру 0-9 и символ под- 
черкивания. Версия \и с заглавной буквой - метасимвол \и - является про- 
ТИВОПОЛОЖнНОСТЬЮ \м. 
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Более идиоматическая версия этой же функции показана в примере 11.13. 


Пример 11.13. Проверка палиндромов в стиле Кот 


Рип 5%г4п9д.15Рапдгоме() = 
481$. оГоиегСазе() .герТасе(“””[\и\+]””” .+оВедех(), “”) 
.Лее { 14 == \{.геуег5ед() } 


Вот основные ее отличия: 


О функция 1$Ралпаготе добавляется в 5{г1пд как функция-расширение, по- 
этому отпадает необходимость в передаче аргумента. В теле функции 
текущая строка доступна по ссылке +115; 

О функция Те{ позволяет записать всю проверку как одно выражение со 
сгенерированной, проверяемой строкой. Локальная переменная {е$*- 
54г4пд больше не нужна; 

О поскольку теперь тело функции представляет собой единое выражение, 
фигурные скобки'были заменены знаком равенства, как это часто быва- 
ет в определениях функций на Кот. 


Оба подхода работают одинаково хорошо, но опытные разработчики на 
Кот скорее предпочтут второй. Разумеется, лучше всего знать оба способа. 
В обоих примерах реализация использует версию гер\асе, которая принимает 
регулярное выражение в первом аргументе. 


Смотри также 
Рецепты 7.3 и 7.4, где обсуждается функция 1е+. 


11.5. ПРЕОБРАЗОВАНИЕ ЧИСЕЛ В ДВОИЧНОЕ 
ПРЕДСТАВЛЕНИЕ И ОБРАТНО 


Задача 


Преобразовать целое число в строку с двоичным представлением (или с пред- 
ставлением в любой другой системе счисления) или строку - в целое число. 


Решение 


Использовать перегруженные версии функций) $о5г1пд и фотп+, принимающие 
аргумент га@х с основанием системы счисления. 


Обсуждение 


Класс 5%гАлдзКЕ содержит встраиваемую (1"Иле) функцию-расширение для Тпё 
сименем +05%г1пд, которая принимает основание системы счисления. Он также 
содержит функцию-распирение для 54г4пд, выполняющую обратное преобра- 
зование. С их помощью можно преобразовать Тп& в строку с двоичным пред- 
ставлением числа (т. е. строку, состоящую из единиц и нулей) и обратно, как 
показано в примере 11.14. 
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Пример 11.14. Преобразование [пе в строку с двоичным представлением и обратно 


@Тез+ 

1пфегпа\ Фип соВ\пагу${гАпдАпаВаск() { 
уа\ $1г = 42.{05%г1па(га@Ах = 2) 
аззег{ТВа{($%г, `1$`(“101010”)) 


уа\ пим = “101010”. оТпЕ(гаФх = 2) 
аззегЕТВа{(пим, `1$`(42)) 


Строка, созданная вызовом +05%г4пд(Тпе), обрезает ведущие нули. Если это 
нежелательно, то можно дополнительно обработать строку с помощью функ- 
ции рад5*аге. 

Допустим, что нам нужно закодировать данные одним двоичным свойством, 
например представить все возможные варианты перестановки из четырех 
игральных карт, которые могут иметь две масти - красную и черную. Это можно 
организовать как простой счет от 0д0.15 в двоичном формате (где 0 представ- 
ляет красный цвет, а 1 - черный или наоборот), но при этом мы не можем по- 
терять ведущие нули. Решить эту задачу можно, как показано в примере 11.15. 


Пример 11.15. Дополнение нулями слева строк с двоичным представлением чисел 


@ТезЕ 
1пфегпа\ Фип раддедВАпагу$г1па() { 
уа\ $1г1п9$ = (0..15).мар { 
14. {054г1п9(2).ра95аг{(4, ‘0’) 
} 


аззегЕТВа{(${г1пд$, сопфа\п$( 
0000”, “0001”, “0010”, “0011”, 
“0100”, “0101”, “0110”, “0111”, 
“1000”, “1001”, “1010”, “1011”, 
“1100”, “1101”, “1110”, “1111”)) 


уа1 пим$ = $4г1п9$.тар { 1*.0Тп(2) } 
аззегЕТВа{(пим$, сопфа\фп$( 

0; 1:2. 3, 

4,5, 6, Т, 

8,9, 10, 11, 

12, 13, 14, 15)) 


Поскольку функции +о5%г\пд и о1пЕ поддерживают все целочисленные ос- 
нования систем счисления, можно не ограничиваться двоичным представле- 
нием, хотя это, пожалуй, наиболее распространенный вариант использования. 
Это означает, что вариант классической шутки (упомянутой в примере 2.27) 
можно представить так: 
уа1 )оКе = “”” 

ТВеге аге ${3.405%г4п9(3)} К1п4$ оР деуеорегз: 
- ТВозе иро Кпом БАпагу, 
- Т№озе иро 4оп”®, апд 
- ТВозе ибо 9419п”Е геа\А2е {1$ 1$ асбиаДу а %егпагу ]оКе 


эээ» 


рглп1лп( оке) 


х. 
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Этот код выведет следующее: 


ТВеге аге 10 К1пд5 оР деуеорегз: 
- ТВозе ипо Кпом БАпагу, 
- ТРозе ипо доп’*, апд 
- ТВозе ипо 94191’ геа|\12е {1$ 1$ асфиаЦу а %егпагу оке. 


11.6. СозддНИЕ ВЫПОЛНЯЕМОГО КЛАССА 


Задача 


Имеется класс с единственной функцией, и требуется максимально упростить 
ее вызов. 


Решение 


Переопределить функцию-оператор \пуоКе в классе так, чтобы она вызывала 
требуемую функцию. 


Обсуждение 
Ко т позволяет переопределять многие операторы. Для этого достаточно все- 
го лишь переопределить соответствующую функцию-оператор. 


В документации к Кот это называется перегрузкой операторов, но 
суть от этого не меняется. 


Чтобы реализовать оператор, нужно определить функцию-член или 
функцию-расширение с предопределенным именем и аргументами. Любая 
функция, переопределяющая оператор, должна объявляться с модификато- 
ром орегафог. 

Особое положение занимает функция 1пуоКе. Функция-оператор \пуоКе по- 
зволяет вызывать экземпляры класса как функции. 

В качестве примера рассмотрим бесплатную веб-службу ВЕЗТЕЛ (БИрз:// 
огей.1у/В$7уп), предоставляемую Ореп Мону, которая возвращает данные ]$ОМ 
с количеством космонавтов в космосе в любой указанный момент времени. 
В примере 11.16 показан образец данных, возвращаемых этой службой. 


Пример 11.16. Образец данных /5О0М, возвращаемых службой Ореп Мо у 


{ 

«реор1е»: [ 
{ «пате»: «О\ед КопопепКо», «сга»: «Т55» }, 
{ «пате»: «ОБа\1Ч ба\л+-Засацез», «сгаР»: «155» }, 
{ «пате»: «Аппе МсС1а%п», «сгаЁ&»: «155» } 

5 

“питбег”: 3, 

“теззаде”: “зиссез$” 
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Судя по ответу, в момент обращения к службе на борту международной кос- 
мической станции находились три космонавта. 

Вложенные объекты ]ЗОМ подразумевают, что для анализа этой структуры 
требуются два класса Кот, как показано в примере 11.17. 


Пример 11.17. Классы данных, моделирующие возвращаемые данные /5О0М 


Чака с\а$$ АзгоВези{( 
уа\ пез5аде: 5&г1пд, 
уа\ питьег: МитБег, 
уа1 реор1е: 115%<А$$19пмеп{> 


) 


Чака с1а$$ Аз$1аптеп{( 
уа1 сгаЁЕ: 5%г\пд, 
уа\ паме: $4г1пд 


Класс Аз$19птеп* представляет комбинацию из имени космонавта и названия 
корабля". Класс Аз+гове 4 используется как общий ответ, который включает 
(будем надеяться) сообщение облуспехе («зиссез$»), количество космонавтов 
и их должности. 

Для случаев, когда требуется выполнить лишь простой НТТР-запрос СЕТ, 
Ко 1 добавил функцию-расширение геадТех* в класс Зауа.пе+.ЦВЕ. То есть, что- 
бы обратиться к службе, достаточно выполнить вызов 


уаг гезропзе = ИВЕ(“ВЕЕр://...”).геадТехЕ() 


и обработать полученный ответ в формате. ]ЗОМ. Так как ОВТ, - это константа 
и для анализа ответа можно использовать библиотеку, такую как Соое Сзоп, 
для доступа к службе разумно создать класс, показанный в примере 11.18. 


Пример 11.18. Обращение к службе ВЕЗТИ! и анализ результата 


1трогЕ сом.90001е.950п.0$0п 
4трогЕ )а\уа.пефе. ЦВЕ 


СТаз$ Аз{гоВеацез* { 


сотраплоп оБдес* { 
рг\\уае сопзЕ ма\ АЗТВО_УВЕ = 
“НЕЕр://ар\.ореп-по\Ру.огд/а$го$. ]з0п” 
} 


// Рип ехесиие(): Аз&гоВези 1 { © 
орегафог Фип 1пуоКе(): Аз&говВези\+ { @ 
уа\ гезропзе5г1па = ИВЕ(А$ТКО_ОВЕ.) .геа@дТех{() 
гефигп (50п().Ргот)зоп(гезропзе5{г\пд, 
АзЕгоВези |: : С1аз$.)а\а) 


© Произвольное имя для включаемой функции 
@ Функция-оператор делает класс выполняемым 


И Здесь «$5» расшифровывается как «ИиегпаНопа! брасе 5{аНоп» - международная 
космическая станция. - Прим. перев. 
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В этом классе ОВГ-адрес службы объявлен в объекте-компаньоне как кон- 
станта, а единственная функция используется и для отправки запроса служ- 
бе, и для преобразования ответа в экземпляр Аз{гоВези\ + с помощью библио- 
теки С$оп. 

Функцию можно было бы назвать как угодно. Если, например, назвать ее 
ехесите, то вызвать ее можно было бы следующим образом: 


уа1 гедие${ = АзгоВедие${() 
уа1 гези\{ = гедиез*.ехеси{е() 
ргАп п (гези{ .меззаде) 


В этом подходе нет ничего плохого, но обратите внимание, что в классе 
имеется только одна функция. Конечно, в Кот есть возможность определять 
функции верхнего уровня, но кажется нецелесообразным объявлять константу 
верхнего уровня с ОВГ службы. Другими словами, гораздо естественнее создать 
класс АзгоВедие${, как было показано выше. 

Поскольку класс преследует единственную цель, можно изменить имя функ- 
ции и добавить к ней ключевое слово орегафог, чтобы сделать выполняемым 
сам класс, как показано в примере 11.19. 


Пример 11.19. Использование выполняемого класса 


1пеегпа\ с1а$$ Аз&гоКедие${Тез+ { 
уа1 гедие${ = АзгоКедие${() ® 


@Те$+ 
1пфегпа1 Фип `деЁ реор{е 1п $расе`() { 
уа1 гези\{ = гедие5*()  @ 
аззег{ТВа{(гези\{.мезЗаде, `1$5`("зиссез5")) 
аззег(ТВа{(гези 1+ .пимег.КоТпе(), 
`15`(дгеафкегТВапОпЕдуа То(0))) 
аззег{ТВа{(гези\{ .реорфе:$\те, 
`1$`(гези{ .пимрег. воТп*())) 


© Создание экземпляра класса 


@ Вызов класса как функции (фактически будет вызвана функция-опера- 
тор 1пуоке) 


Поскольку АзЕгоВези\{ и Аз$1дпмепЕ являются классами данных, их содержи- 
мое, показанное ниже, всегда можно вывести с помощью функции ргАп п: 
Аз{говези1+(теззаде=зиссез$, питфег=3, 

реор1е=[Аз519пмеп{ (сга#{=Т55, паме=О1ед КопопепКо), 


Аз519пмепЕ (сга(=Т55, паме=Оба\4Ч За1п*-2асдуез), 
Аз519пмепЕ (сга(=Т55, паме=Аппе МсСТа\п)]) 


Тесты проверяют отдельные свойства. 

Добавление в класс функции-оператора \1пуоКе позволяет выполнять его эк- 
земпляры непосредственно, добавляя круглые скобки к ссылкам на них. При 
желании можно также определить перегруженные версии функции \пуоКе слю- 
быми необходимыми аргументами. 
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Смотри также 
Рецепт 3.5, где более подробно обсуждается возможность перегрузки операторов. 


11.7. ИзмЕРЕНИЕ ПРОШЕДШЕГОЛВРЕМЕНИ 


Задача 
Узнать, как долго выполняется блок кода. 


Решение 


Использовать функции пеазигеТАмем 1115 и меазигеМапоТ\ме из стандартной биб- 
лиотеки. 


Обсуждение 


Пакет КоНт.зует включает функции пеазигеТАмем Д\$ и пмеазигеМапоТА ме. 
Их с успехом можно использовать для определения интервала времени, в те- 
чение которого выполнялся блок кода, как показано в примере 11.20. 


Пример 11.20. Измерение времени выполнения блока кода 


Рип дочуЛете(х: Тпе): Тм { 
Твгеа4. $1еер( 1001.) 


ргАп п(“доч6Ап9 $х илЕН оп {Вгеад ${ТВгеад. сиггеп{ТВгеа4() .паме}”) 
гефигпх * 2 


Рип пафп() { 
ргАп 1п("${ВипЕА ме .деВип\ме().ауаЛаБЛеРгосе$$0ог$()} ргосе$$ог$”) 


уаг Е1те = меазигеТАмем1 111$ { 
Тпё5геам.гапдеС10о$е4(1, 6) 
„мар { дочБЛет&(1*) } 
.5им() 
} 


ргап п(“бедцеп\а1 згеат Фоок ${{1мте}т5”) 


{ме = меазигеТАмем Л $ { 
Тпё5геам. гапдеС10о$е4(1 6) 
„рагае1() 
‚тар { ЧдочЛет&(14)`} 
.5ит() 


} 


ргАп 1п(“РагаЦе\ з%геам фоок ${+1ме}т$”) 


Этот фрагмент выведет примерно следующее: 


ТВ\$ масрАпе Ваз 8 ргосе$$ог$ 
Чдоч6 Ап 1 мА ЕН оп {Вгеа ма\п 
Чоч6Ап9 2 мАЕН оп ВгеаФ майп 
доу 11п9 3 и оп ВгеаФ ма\фп 


х. 
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Чдоч6Ап9 4 и\ЕН оп {ВгеаФ ма\п 

доу 11п9 5 и оп ВгеаФ ма\п 

доч611п9 6 и В оп геаФ ма\п 

бедиеп{1а1 зЕгеам ФооК 616т5 

доу 11п9 3 и ЕВ оп ЕПгеад РогКЗо\пРоо\.. сомтопРоо1 -могКег-11 


Чдоч61п9 4 и\ЕН оп ВгеаФ ма\п 

доу611п9 5 и\ЕН оп геад РогК2о\пРоо\.. сомтопРоо\ -могКег-7 
доу611п9 6 и\ В оп геад РогК3о1пРоо; сомтопРос\ -могКег-3 
доч611п9 2 и оп геад РогК2о\пРоо\/ сомтопРос1 -могКег-5 
доуБ11п9 1 и В оп ЕРгеад РогКо\пРооасоттопРос1 -могКег-9 


Рага\Де1. °{Егеам фооК 110$ 


В данном конкретном случае ]УМ сообщает о восьми процессорах, поэто- 
му функция рага1е1 потока данных разделила работу между ними, и каждый 
процессор получил один элемент для удвоения. В результате параллельное вы- 
полнение операций заняло всего около 100 миллисекунд, тогда как последова- 
тельное выполнение заняло около 600 миллисекунд. 

В примере 11.21 показана реализация функции пеазигеТАтем 115 в стандарт- 
ной библиотеке. 


Пример 11.21. Реализация функции теазигеТитемИИ$ 


рус 1пИ пе Гип меазигеТ\тем1 111$ (БЛоск: () -> Уп): [опа { 
уа\ зтаг{ = буз(ет. сиггеп& ТАмем 115$ () 
Ыоск() 
гефигп бузфем. сиггепТ\мем1115() - эфагЕ 


Это - функция высшего порядка, потому что принимает аргумент с лямбда- 
выражением, и поэтому, для большей эффективности, она объявлена встраива- 
емой (11 ле). Реализация просто вызывает ]ауа-метод 5уз{епт. сиггепТамем 5 
до и после выполнения аргумента Лоск. Реализация пеазигеМапоТ4ме действует 
точно так же, но вызывает 5у${епт.папоТ\ме. 

Эти две функции упрощают профилирование производительности кода. 
Более точные оценки времени можно получить с помощью проекта ]ауа 
МиегобепсЬтагК Нагпез$ МН) в Ореп]ОК (Брз://оте|.[у/М6ВВУ). 


11.8. ЗАПУСК ПОТОКОВ ВЫПОЛНЕНИЯ 


Задача 
Выполнить блок кода в параллельном потоке выполнения. 


Решение 
Использовать функцию {Вгеад из пакета КоЙт.сопсигтепе. 


Обсуждение 


В Кот имеется простая функция-расшгирение *йгеад, которую можно исполь- 
зовать для создания и запуска потоков выполнения. Вот как выглядит сигна- 
тура функции геа4: 
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Рип {Бгеа9( 


<фаг{: Воо\еап = гие, 
15Обаетоп: Воо\еап = Фа\5е, 
сопеехЕСТа$$1оадег: СТаз$1оа4ег? = пи, 
паме: 5%г1пд? = пиД, 
рглог\ у: ТпЕ = -1, 
Ыоск: () -> Уп 

): Тргеад 


Поскольку параметр $+аг* имеет значение по умолчанию «гие, это упрощает 
создание и запуск нескольких потоков, как показано в примере 11.22. 


Пример 11.22. Запуск нескольких потоков выполнения через случайные интервалы времени 


(0..5).РогЕасВ {п -> 
уа\ $1еерТАме = Вапдом. пех{1опд(гапде = 0..10001) 
{Пгеад { 
ТВгеад. $\еер($1еерТ4ме) 
ргАп 1п(“${ТВгеад.сиггепТВгеад().паме} Рог $п аЁ%ег\ $51еерТ\ме}т5”) 


Этот код запускает шесть потоков выполнения, каждый из которых приоста- 
навливается на случайное количество миллисекунд от 0 до 1000, а затем выво- 
дит свое имя. Результат выглядит примерно так: 


ТВгеад-2 Рог 2 аЁРег 184$ 
ТВгеад-5 Рог 5 аЁР%ег 207м$ 
ТВгеад-4 Рог 4 аЁР%ег 8475 
ТВгеа9-09 Рог 0 аЁег 917м$ 
ТВгеад-3 Рог 3 аЁ%ег 967м$ 
ТВгеад-1 Рог 1 аЁР%ег 9805 


Обратите внимание, что нет необходимости вызывать ${аг* для запуска каж- 
дого потока выполнения, потому что параметр *аг* в функции геад по умол- 
чанию получает значение %гие. 

Параметр 15Баетоп позволяет создавать потоки-демоны. Если все потоки вы- 
полнения в приложении, кроме главного, являются потоками-демонами, то 
приложение можно завершить без лишних сложностей. Другими словами, если 
предыдущий пример переписать, как показано в примере 11.23, он вообще ни- 
чего не выведет, потому что функция пал завершится раньше, чем успеют вы- 
полниться потоки. 


Пример 11.23. Запуск потоков-демонов 


(0..5).РогЕасВ {п -> 
уа\ $1еерТАме = Вапдом. пех{1опд(гапде = 0..10001) 
{Ргеад(15Баемоп = {гие) { ® 
ТВгеад. $1еер($1еерТАме) 
ргАп 1 лп("${ТВгеад .сиггепТВгеа9().паме} Рог $п аЁ%ег ${$1еерТАме}м$") 


© Потоки запускаются как потоки-демоны, поэтому главный поток выпол- 
нения не ждет их завершения и завершает программу раньше 


. 
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Блок кода, передаваемый в функцию *йгеад, —- это лямбда-выражение без 
аргументов и возвращающее Ип\+, что соответствует интерфейсу ВиппаЛе, или, 
говоря проще, сигнатуре метода гип в Тигеад. В примере 11.24 показана реали- 
зация функции *йгеад. 


Пример 11.24. Реализация функции {Пгеад в стандартной библиотеке 


рус Рип Бгеа9( 
<фаг{: Воо\еап = гие, 
15Оаетоп: Воо\еап = Фа\5е, 
сопеехЕСТа$$1оадег: СТаз$1оа4дег? = пи Д., 
паме: 5%г1п9? = пиД, 
рглог\у: ТпЕ = -1, 
Ыоск: () -> Уп 
): ТЬгеад { 
уа\ ЕВгеаФ = оБдесе : Тргеад() { 
рус омеггАе Рип гип() { 
Ыоск() 
} 


1+ (1$Оаетоп) 


{Вгеад.15Оаетоп = гие 
АЕ (рмог\у > 0) 
{Вгеад.рглогАЕу = рглог\ фу 


АЕ (пате != пи \) 
{Вгеад.пате = паме 
44 (сопЕехЕСТаз$Гоа4дег != пи 1.) 
{Вгеад. соп{ех{СЛа$$[оадег = соп%ехЕСТазЁГоадег 
АЕ (5фагЕ) 
{Вгеад. $аг{() 
гефигп {Вгеад 


Реализация создает объект типа Тигеад и переопределяет его метод гип для 
вызова заданного блока Боск. Затем она устанавливает различные свойства 
и вызывает э+аг*. 

Поскольку функция возвращает созданный поток, есть возможность запустить 
все потоки последовательно, вызвав метод 1о\п, как показано в примере 11.25. 


Пример 11.25. Присоединение потоков выполнения друг к другу 


(0..5).РогЕасВ {п -> 
уа\ $1еерТАме = Вапдом. пех{Гопд(гапде = 0..10001) 
{Вгеад { 
ТВгеад. $1еер($1еерТ4ме) 
ргп л(“${ТВгеа4.сиггепЕТВгеа9().паме} Рог $п аЁ%ег ${$1еерТАме}м5”) 
}.]01п() ® 


о Присоединяет каждый следующий поток выполнения к предыдущему 


Вот как примерно будет выглядеть вывод этого кода: 


ТВгеа9-0 Рог 0 аЁР%ег 687м5 
ТВгеад-1 Рог 1 аЁР%ег 661м$ 
ТВгеад-2 Рог 2 аЁ%ег 430$ 
ТВгеад-3 Рог 3 аЁег 412м5 
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ТВгеад-4 Рог 4 аЁег 918м5 
ТВгеад-5 Рог 5 аЁР%ег 755$ 


Этот прием в первую очередь избавляет от необходимости запускать одни 
потоки внутри других, но также демонстрирует возможность вызова методов 
возвращаемых потоков. 


Смотри также 


Главу 13, где подробно рассматриваются вопросы параллельного и конкурент- 
ного выполнения. 


11.9. ПРИНУЖДЕНИЕ К ЗАВЕРШЕНИЮ РЕАЛИЗАЦИИ 
с помощью ТОБО 


Задача 
Гарантировать завершение реализации определенной функции или теста. 


Решение 


Использовать функцию 1000 (с необязательным аргументом геазоп), которая ге- 
нерирует исключение. 


Обсуждение 

Разработчики часто оставляют для себя примечания, описывающие необхо- 
димость завершить реализацию функции, которую они не могут завершить 
в данный момент. В большинстве языков программирования для этого добав- 
ляется оператор «ТОО» в комментарий, например: 


Рип муСТеуегРипс\оп() { 
[/ Т000: придумать хорошую реализацию 
} 


Стандартная библиотека Ко т включает функцию 1000, реализация которой 
показана в примере 11.26. 
Пример 11.26. Реализация функции ТОБО 


рус 1ппе Рип Т000(геазоп: 5%г4п9): №1 па = 
ЕВгом Мо{Ттр1етепеедЕггог(“Ап орега1оп 1$ поф 1тр\емеп{е4: $геазоп”) 


Для большей эффективности функция объявлена встраиваемой и при ее вы- 
зове генерирует исключение №\{1Тптр1етеп{едЕггог. Ее легко использовать, как по- 
казано в примере 11.27. 


Пример 11.27. Типичное использование функции ТОБО 


Рип пафп() { 
Т000(геазоп = “попе, геаДу”) 
} 


Рип сомр\ефетН1$() { 
т000() 


х. 
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При попытке выполнить этот код он выведет: 


Ехсер оп 1п ВгеаФ «ма1п» Ко Ап .Мо{Ттр\етепедЕггог: 
Ап орега\оп 1$ поф \мр\етепфед: попе, геаДу 
а т\с. Тодо$КЕ .ма\п(%040$.К{:4) 
аЕ т1$с.Тодо$К{ .ма\п(+040$.К{) 


В необязательном аргументе геазоп можно объяснить намерения разработ- 
чика. 

Функцию 1000 также можно использовать’в тестах, чтобы генерировать ис- 
ключение, пока тест не будет окончательно реализован, как показано в при- 
мере 11.28. 


Пример 11.28. Использование функции ТОБО в тесте 


Рип `{04до %е$5*`() { 
уа1 ехсер{оп = аззегЕТАгои$<№*Ттр\етепфедЕггог> { 
Т000(“зеглои$Ту, РАплзН {[15”) 
} 


аззег{Едиа1$(“Ап орегаоп 15 поЁ 1тр\емеп{ед: зеглоц$1у, РАплзН ЕР15”, 
ехсер\оп.теззаде) 


Функция 1000 — одно из множества дополнительных удобств в библиотеке, 
которые легко не заметить, пока кто-нибудь не укажет на них. Надеюсь, вы 
сможете найти способы воспользоваться этими удобствами. 


11.10. СлучАЙНОЕ ПОВЕДЕНИЕ КЛАССА КАМООМ 


Задача 
Сгенерировать случайное число. 


Решение 
Использовать одну из функций класса Вапдот. 


Обсуждение 


Класс Ко Ап .гапдом.Капдом прост в использовании, но имеет довольно замысло- 
ватую реализацию. Во-первых, самое простое - получить случайное целое чис- 
ло можно с помощью одной из перегруженных версий пех Тп+. В документации 
с описанием Ко 4п.гапдопт.Вапдот говорится, что это абстрактный класс, но он 
включает методы, перечисленные в примере 11.29. 


Пример 11.29. Объявления функций в абстрактном классе Капдот 


ореп Фип пехЕТпе(): ТпЕ 
ореп Фип пехЕТпЕ(ипЕ 1: ТпЕ): ТЕ 
ореп Фип пехЕТпЕ(Ргот: Тпё, ип: Тпе): ТП 


Все три функции имеют реализации по умолчанию. Использовать их доста- 
точно просто, как показано в примере 11.50. 
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Пример 11.350. Перегруженные версии функции пех пе 


@Тезе 
Рип `пехЕТпЕ и\ЕН по аг9д$ 91\е$ апу Тп`() { 
уа1 уа\ие = Вапдот.пех&Тпе() 
аззег{Тгие (уа\ие 1п Тпё.МТМ МАШЕ. .Тпе.МАХ_\АЕОЕ) 


| 


@Тез+ 

Рип `пехЕТпЕ и\ЕН а гапде 91\ез уа\ие Бе{мееп 0 апд Ат `() { 
уа1 уа\ие = Вапдот.пехТпЕ(10) 
аззег{Тгие(уа\ие 1п 0..10) 


} 


@Тез+ 

Рип `пехЕТпе ил ЕН Ап апФ мах 91\%е$ уа\ие Бефмееп +Вепт`() { 
уа\ уа\ше = Вапдот.пехЕТп(5, 10) 
аззег{Тгие(уа\ие 1п 5..10) 


} 


@ТезЕ 

Рип `пехЕТпЕ илЕВ гапде гефигпз уа\ие 4п гапде`() { 
уа1 уа\ие = Вапдот.пех&ТпЕ(7..12) 
аззег&Тгие(уа\ие 1п 7..12) 


Последний пример не перечислен в списке функций в классе Вапдот, потому 
что это - функция-расширение со следующей сигнатурой: 


Рип Капдом. пех Тп(гапде: ТпЕВапде): Тпё 


Если заглянуть в файл с исходным'кодом предыдущих тестов, то можно уви- 
деть, что он импортирует Ко \Ап.гапдом.Вапдот и Ко{Ап.гапдом.пехТпе, где пех- 
{То - это функция-расширение. 

Класс Вапдом имеет довольно интересную реализацию. Она включает методы, 
перечисленные в примере 11.29, за которыми следует объект-компаньон типа 
Вапдот. В примере 11.31 показан фрагмент реализации. 


Пример 11.31. Объект-компаньон класса Капдот 


сомрап1фоп обес БеФац 1 : Вапдом() { 
рг\\афе уа1 деРаи\{Вапдот: Капдом = деРаи {РТа{РогмВапдот() 


оуегг14де Фип пехЕТпе(): ТпЕ = деРац\{Вапдом.пехЕТпе() 
оуегг\4е Рип пехЕТп (ип: Тпё): Тпё = деРау({Вапдот. пехЕТп (ип 1.) 
оуегг\4е Фип пехЕТпЕ(Ргом: Тпё, ип 1: Тпё): Тпё = 

деРа {Вапдом. пехТп(Ргом, ипЕ11.) 


И ела 


Объект-компаньон получает реализацию по умолчанию и переопределяет 
все объявленные методы так, что они вызывают реализацию по умолчанию. 
ЧеРац\&Р1а{РогмВап4ом — это внутренняя функция. 

Аналогично реализованы другие типы, такие как Воб1еап, Ву{е, Еоа{*, 1опд 
и боиТе, а также беззнаковые типы ЦВу*ез, ИТп* и Шопд. 


х. 
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Но самое интересное, что существует также функция с именем Вапдом, кото- 
рая принимает начальное значение типа Тп+ или !опд и возвращает воспроиз- 
водимый генератор случайных чисел, инициализированный аргументом (см. 
пример 11.32). 


Пример 11.52. Использование инициализированного генератора случайных чисел 


@Тез+ 

Рип `Вапдом Кипс\оп ргодисез а зеедеФ депегафог`() { 
уа\ г1 = Вапдом( 12345) 
уа1 пим$1 = (1..10).тар { г1.пехЕТпе() } 


уа1 г2 = Вапдом( 12345) 
уа\ пит$2 = (1..10).тар { г2.пехЕТпе() } 


аззегЕЕдца\$(пит$1, пиут$2) 


Если создать два генератора, инициализированных одним и тем же началь- 
ным числом, то оба будут генерировать одну и ту же последовательность слу- 
чайных чисел. 

Генераторы случайных чисел в Кот просты в использовании, но изучение 
реализации методов (с использованием абстрактного класса, методы которо- 
го переопределяются внутри объекта-компаньона) может дать представление 
о том, как разрабатывать собственные классы. 


11.11. Использовдни СПЕЦИАЛЬНЫХ 
СИМВОЛОВ В ИМЕНАХ ФУНКЦИЙ 


Задача 
Написать функции с легко читаемыми именами. 


Решение 


Использовать символ подчеркивания или заключить имя функции В обратные 
кавычки, но только в тестах. 


Обсуждение 

Ко 1 позволяет заключать имена функций в обратные кавычки, как показано 
в примере 11.53. 

Пример 11.33. Заключение имен функций в обратные кавычки 


Рип `оп1у узе БаскК&сК$ оп %е5е Рипс\оп$`() { 
ргАп1п(“ТВА$ могК$ Би 15$ по{ф а 9004 14еа”) 
} 


Тип пафп() { 
`опП1у изе БасК&сК$ оп %ез Рипс\оп$`() 


} 


182 *% Разное 


Заключение в обратные кавычки позволяет использовать в именах про- 
белы. Но если применить этот прием в отношении имени обычной функции, 
Пе] ШЕА отметит это, сообщив: «Имя функции может содержать только бук- 
вы и цифры». Такая функция будет компилироваться и выполняться, как по- 
казано выше, но подобную практику нельзя назвать удачной. 

Другой вариант -— использовать символы подчеркивания, как в приме- 
ре 11.54. 


Пример 11.34. Использование символа подчеркивания в именах функций 


Рип ипдег$согез_аге_а1зо_оКау_оп1у_оп_{е${$() { 
ргАп 1п(“Адафп, р\еазе 4оп’& до {1$ оц%$14е оЁ {е$15”) 


) 


ип пафп() { 
ипдегзсогез_аге_а1$0_оКау_оп1у_оп_+е$%$() 
} 


Такие функции тоже будут компилироваться и выполняться, но компилятор 
выдаст предупреждение: «Имя функции не должно содержать символов под- 
черкивания». 

Однако в тестах можно свободно использовать любой из перечисленных 
приемов, и такой код будет считаться идиоматическим, как отмечается в ру- 
ководстве «Со те Сопуепопз» (В рз://огей.Лу/хеча). Так что имена, показан- 
ные в примере 11.55, с успехом могут использоваться в тестах. 


Пример 11.35. Имена тестовых функций могут оформляться любым удобным способом 


СТаз$ Рипс\опМамезТез{ { 


@Те$+ 
Рип `БаскЕсК$ маКе Рог геадаБ\е %е$% памез`() { 


ПИ а 
} 


@Те$+ 
Рип ипдег$соге$_аге_Рпе_Веге_+о0() { 


ИИ лыж 
} 


Более того, такие легко читаемые имена будут отображаться в отчете о тес- 
тировании, поэтому все, что делает результаты тестирования более понятны- 
ми, - это хорошо. 


11.12. ПЕРЕДАЧА ИСКЛЮЧЕНИЙ В АМА 


Задача 


Исключение, генерируемое функцией на Кот, должно рассматриваться ко- 
дом на ]ауа как контролируемое, но об этом нужно сообщить явно. 
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Решение 
Добавить в сигнатуру функции аннотанию"@ТПгом$. 


Обсуждение 


В Кот все исключения считаются неконтролируемыми, то есть компилятор 
не требует их обработки. Чтобы перехватить исключение в функции на Кот, 
можно добавить блок {ту/сасЬ/бпаПу, но поступать так необязательно. 


В Ко т нет ключевого слова {Вгоиз, которое ]ауа использует для объ- 
явления методов, которые могут сгенерировать исключение. 


Ситуация меняется, когда возникает необходимость вызвать такую функ- 
цию из ]ауа. Если функция на Кош может сгенерировать исключение, которое 
код на ]ауа должен считать контролируемым, то вы должны сообщить об этом, 
чтобы дать возможность перехватить его. 

Например, предположим, что есть функция на Ко т, которая генерирует ис- 
ключение Т0Ехсер1оп, являющееся контролируемым в ]ауа, как показано в при- 
мере 11.56. 


Пример 11.56. Функция на Кот, генерирующая исключение 1ОЕхсерйоп 


Рип Боу$фопМеНамеАРго\ем() { 
4Вгом ТОЕхсер\оп(“РАДе ог гезоигсе по Фоупд”) 


} 


Чтобы скомпилировать эту функцию на Ко т, не нужен блок ту/сайсВ или 
предложение "йгоиз. Как показано в примере, функция генерирует исключение 
ТОЕхсер\оп. 

Эту функцию можно вызвать из ]ауа, и в результате возникнет исключение, 
как показано в примере 11.37. 


Пример 11.37. Вызов функции на Кот из /ауа 


рус зас уо19 Чдо№*РАп9() { 
БоизфопмеНауеАРго\ет(); ® 


} 


© Вызовет аварийное завершение с исключением ТОЕхсер1оп 


(Исходный код для этого примера включает статический импорт вызывае- 
мой функции.) 

Проблема возникнет, если вы решите обработать исключение ТОЕхсер1оп, за- 
ключив вызов в блок (гу/са{сВ или добавив предложение +Вгоиз к определению 
функции в ]ауа, как показано в примере 11.38. 
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Пример 11.38. Попытка перехватить ожидаемое исключение 


руБЛАс Кас мо изеТгуСаесАВ\оск() { 
о 


{гу { 
ВоизопМеНауеАРго1ем( ) ; 


} сафсн (ТОЕхсер\оп е) { 
е.ргАпЕ5{асКТгасе(); 
} 


} 


руБ\Лс ас 014 изеТАгом$СТаизе() ЕРгоиз ТОЕхсер оп { @ 
Роуз опиеНамеАРго\емт() ; 
} 


© Не компилируется 


@ Компилируется, но компилятор предупреждает о «ненужности» предло- 
жения {Нгои$ 


Ни один из этих приемов не дает желаемого результата. Если добавить яв- 
ный блок {ту/саесЬ, код не скомпилируется, так как ]ауа считает, что исключе- 
ние ТОЕхсер оп, указанное в блоке са{сй, никогда не возникает в соответству- 
ющем блоке {гу. Во втором случае код скомпилируется, но среда разработки 
(и компилятор) предупредит, что в коде присутствует ненужное предложение. 

Чтобы оба подхода заработали, нужно добавить аннотацию @Тгои$ в код на 
Кот, как показано в примере 11.59. 


Пример 11.39. Добавление аннотации @ ТВго\$ 


@ТАгом$ (ТОЕхсер оп: :с1а5$) ® 
Рип Боу$фопМеНауеАРгоБ\ем() { 

4Вгом ТОЕхсер\оп(“РАДе ог гезоигсе по{ Фоуп4”) 
} 


© Сообщить ]ауа, что эта функция может сгенерировать исключение Т0Ех- 
сер оп 


Теперь компилятор ]ауа будет знать, что может возникнуть исключение 
ТОЕхсер оп, и функция 4о№*{В\А пд перестанет компилироваться, потому что вы 
должны организовать обработку контролируемого исключения ТОЕхсер оп. 

Аннотация @Тгоиз существует только для интеграции ]ауа и Кот. Она ре- 
шает конкретную проблему, но работает именно так, как можно заключить из 
ее названия. 


ава 1.2 


Фреймворк $ритд 


Фреймворк 5рип® - один из самых популярных фреймворков с открытым ис- 
ходным кодом в мире ]ауа. Цель $рипе - предоставить инфраструктуру для ва- 
шего проекта. Он позволяет сосредоточиться на разработке Беап-компонентов 
с прикладной логикой, беря на себя решение всех остальных задач, таких как 
безопасность, транзакции, управление ресурсами и многих других, с учетом 
предоставленных вами метаданных. 

Фреймворк $рипе всегда дружил с «альтернативными» языками ]УМ. 
Он поддерживает Стооуу начиная с версии 2.5. В последних версиях разработ- 
чики $рИпе также добавили возможности, уникальные для Кот. 

В этой главе представлено несколько избранных приемов, которые мож- 
но использовать в коде на Кот в приложениях для 5рише. Поддержка Кот 
в $рипе продолжает эволюционировать, но эта глава должна дать вам пред- 
ставление о том, как Кот вписывается в экосистему 5рипе. 


12.1. ОткРЫТИЕ КЛАССОВ ДЛЯ РАСШИРЕНИЯ 
ФРЕЙМВОРКОМ УРЕИМб 


Задача 


Фреймворк $рише генерирует прокси-объекты, расширяя прикладные классы, 
но в Кот классы закрыты по умолчанию (объявлены как #\па\ в ]ауа). 


Решение 


Добавить плагин поддержки 5рипе в файл сборки. Он автоматически откроет 
для расширения все необходимые классы. 


Обсуждение 


Фреймворк 5рипе предоставляет приложению множество услуг. Для этого 
он использует шаблон проектирования «Заместитель» (Ргоху)”. Организация 
и работа этого шаблона показаны на диаграмме ОМЕ. классов и диаграмме по- 
следовательности выполнения операций на рис. 12.1. 


? ребрз://гамреа.оге/\КИЗаместитель (шаблон_проектирования). - Прим. перев. 
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Пример диаграммы классов 


Д\ 


орегаоп() 
’ 

Га 
... ГА 
геабиБесг.орегаНоп(); 


Рис. 12.1. Диаграмма ИМЕ шаблона проектирования «Заместитель» 


Пример диаграммы последовательности 


:Веаби ес 


0 1 
орега{оп() 


орегаНоп() 


орегаНоп() |ВеабиБесе 


Идея состоит в том, что заместитель (Ргоху) и реальный субъект (Веа]биБ]есЕ) 
реализуют один и тот же интерфейс или расширяют (наследуют) один и тот же 
класс. Входящий запрос перехватывается заместителем, который выполняет 
все необходимые предварительные операции, а затем пересылает запрос ре- 
альному субъекту. Заместитель также может перехватить ответ и при необхо- 
димости выполнить дополнительную работу. Например, заместитель механиз- 
ма управления транзакциями в 5ритз перехватывает вызов метода, запускает 
транзакцию, вызывает метод и затем вызывает сом или го ЦБаск, в зависимо- 
сти от результата выполнения метода реального субъекта. 

Фреймворк 5рише генерирует объекты-заместители во время запуска. Если 
реальный субъект - это класс, то фреймворк должен расширить его, и в этом 
случае в Ко 11 возникает проблема. Дело в том, что код на Кот по умолча- 
нию связывается статически, то есть вы не сможете переопределить метод или 
расширить класс, если он не был отмечен как открытый для расширения с по- 
мощью ключевого слова ореп. 

Для решения подобных проблем в Ко 1 есть плагин аЙ-ореп. Этот плагин 
открывает классы, отмеченные указанной аннотацией, не требуя явно добав- 
лять ключевое слово ореп к классу и к функциям внем: 

Это довольно удобный плагин, но разработчики языка пошли еще дальше 
и создали плагин КоНт-зрите специально для поддержки $рйпе. Чтобы за- 
действовать этот плагин, его нужно добавить в файл сборки Ста е или Мауеп. 
В примере 12.1 показан фрагмент файла сборки Ста е (на языке Кот О5Г), 
подключающий этот плагин. Файл называется БиНа.этае.К5 и был создан 
с помощью инструмента 5рите ша|2т (ВЕ рз://а".зрит8.10/). 


12.1. Открытие классов для расширения фреймворком 5$рипа * 


Пример 12.1. Добавление плагина Ко{Ип-5рипд в файл сборки 


1троге огд. }е{Бга\п$ .Ко{ Ап .дга Фе. ЕазК$ Ко АпСоптр Де 


р\и9\п$ { 
19(“огд.зргАпаРгамемогк.Боо*”) мег51оп“2.1.8.ВЕТЕАЗЕ” 
19(“Чо.5рг\1пд.Черепдепсу-тападетеп{”) уеп51оп “1.0.8.ВЕГЕАЗЕ” 
Ко А п(“ мм”) мег$\оп “1.2.71” © 
Кот ("р1ид1п.5рг1пд") мег$\1оп "1.2.71" @ 
} 


9гоир = "сом.тусотрапу" 
уег51оп = "1.0" 


]ама. зоигсеСомра АБАДАЕу = Зауа\ег$1оп./ЕВЗТОМ_11 


геро$\Фог4е$ { 
мауепСеп{га\() 
} 


ерепдепс\1е$ { 
1тр\етепфа{\оп( "ога. зрг1пдгамемогК .Боо* : зргАпд-Боо*-$фагфег") 
1тр\етепфа{\оп("огд. ]}е{Бга\1п$ . Ко п: Ко А п-ге ес*") [3 
1мр1етепа\оп("огд. ]}еБга\п$ Ко Ап: Ко Ил -5Е91-99К8") ® 
{е${Ттр1етепфаТоп("огд.зрг\пдРгатемогК .Боо* : зрг1па-Боо{-$фаг%ег-+е$*") 


} 


фа$К$ .иАЕВТуре<Ко 1пСотрДе> { 
Ко А пОроп$ { 
ТгееСопр\ДегАгд$ = 11540("-Х)$г305=$4 гс") [4 
ЭмтТагде* = "1.8" 


© Добавление плагина Кот ]УМ в проект 

@ Добавление плагина КоНт 5р!пе 

© Необходимо, если исходный код проекта написан на Кот 
© Подключение аннотаций ]5В-305 поддержки значения пи. 


Плагин аЙ-ореп позволяет определить аннотации для объявления открытых 
классов Кот. Плагин КоНт-5рипз уже настроен для поддержки следующихан- 


нотаций эр!!пе: 
О @Соптропепе; 
О (@Азупс; 
О @ТгапзасопаТ; 
О @СасвеаЛе; 
О @бргАпдВоо{Тез+. 


Аннотация @Сотропеп{ используется в нескольких других аннотациях 5ри!пе, 
включая @СопАдига оп, @СопЕгоДег, @Ве${СопегоДег, @бегуАсе и @Вероз\Хогу. 
Все управляемые Беап-компоненты 5$рип®, отмеченные любой из этих анно- 
таций, автоматически открываются для расширения, чего часто бывает более 


чем достаточно. 
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Если потребуется выйти за рамки данного плагина, добавьте плагин а[-ореп, 
но обычно в этом нет необходимости. 


Чтобы увидеть файл сборки для Мауей, использующий тот же плагин, 
сгенерируйте проект Мауеп с помощью пШаН7г. 


Смотри также 
Рецепт 12.2, где обсуждается плагин КоНт-]ра. 


12.2. ХРАНИМЫЕ КЛАССЫ ДАННЫХ НА Котим 


Задача 
Использовать ]ауа Рег$1${епсе АРТ (РА) с классами данных Кот. 


Решение 
Добавить плагин КоЙт-/ра в файл сборки. 


Обсуждение 


Обычно при определении класса данных все необходимые свойства добавля- 
ются в основной конструктор, как показано в примере 12.2. 


Пример 12.2. Класс данных с основным конструктором 


Дафа с\а$$ Регзоп(ма\ паме: 54г1пд, 
уа\ доб: [оса\а{е) 


С точки зрения ]РА здесь есть две проблемы. Во-первых, ]РА требует нали- 
чия в классе конструктора по умолчанию, а для этого необходимо указать зна- 
чения по умолчанию для всех свойств. Во-вторых, объявление класса данных 
со свойствами уа1 повлечет создание неизменяемых объектов, а механизм ]РА 
не предназначен для работы с неизменяемыми объектами. 

Сначала решим проблему с конструктором по умолчанию. Для этого в Кот 
имеется два плагина. Первый плагин - по-аге - позволяет выбирать, какие 
классы должны иметь конструктор без аргументов, и определять аннотации 
для их вызова. Второй плагин - КоИт-ра - автоматически настраивает сущно- 
сти Кот (например, классы, отмеченныеаннотацией @Еп у, которые демон- 
стрируются в этом рецепте), добавляя конструкторы по умолчанию. 

По аналогии с плагином КоНт-з5рите, описанным в рецепте 12.1, чтобы вос- 
пользоваться этими плагинами, необходимо добавить соответствующие ин- 
струкции в файл сборки. В предыдущем рецепте, в примере 12.1, было показа- 
но, как подключить плагин КоНт-5рттз в файле сборки Ста@е (на Кот ОГ). 
Опираясь на этот пример, внесите необходимые дополнения в БиЙа.етае.К15 
из примера 12.1, как показано в примере 12.3. 
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Пример 12.3. Дополнительные зависимости для поддержки сущностей }РА 


р\и91п$ { 

// ... как и прежде... 

Ко Ап («р1и91п.)ра») уегз\1оп «1.2.71» 
} 


// ... другие настройки, как и прежде ... 


Черепдепс\е$ { 
// ... другие зависимости из предыдущего рецепта... 
1пр\емепфа{\оп(«огд.зрг1пдгатемогКк .Боо* : зрг1па-Боо*-$фаг{ег-Чаа-)ра») 
1тр\етепфа{\оп(«сот. Раз{егхм\.. ДасКзоп.тодие : ласКзоп-поди\е-Ко п») 


Зависимость )асКзоп-тоди\е-Ко{ Ап не требуется для поддержки сущ- 
ностей, но она помогает сериализовать классы Кот в формат ]$ОМ 
и обратно с помощью библиотеки ]асКзоп 2. 


Плагин по-аге компилятора добавляет синтетический конструктор по умол- 
чанию в классы на Кот. Этот конструктор невозможно вызвать из ]ауа или 
Ко, но $рише сможет сделать это с помощью механизма рефлексии. Вы мо- 
жете использовать этот плагин, но тогда вам придется определить аннотации 
для отметки классов, которым необходим конструктор без аргументов. 

Как показано в примере 12.5, плагин КоИт-ра намного проще в использова- 
нии. Он основан на плагине по-аге и автоматически добавляет конструкторы 
по умолчанию в любые классы, отмеченные аннотациями: 


О @Епи\ху; 
О @ЕтЬеддае; 
О (@Марреф$ирегс\а$$. 


Вторая проблема заключается в том, что ]РА не умеет работать с неизменяе- 
мыми сущностями. Поэтому команда 5рипе рекомендует использовать в роли 
сущностей только обычные классы (не классы данных) со свойствами уаг, что- 
бы значения полей можн@ было изменять. В примере 12.4 показан вариант ис- 
пользования 5рипе Воо( с Кот из учебника 5рипе. 


Пример 12.4. Классы Кот, отображающиеся в таблицы в базе данных 


@ЕпЕтеу 
СТаз$$ Аг с1е( 
уаг {11е: 5%г\1пд, 
уаг Беад\1пе: 5%гАлпд, 
\уаг сопфепе: 5+гАлпд, 
@МапуТо0пе маг ацВог: Цег, 
уаг $1419: 54г4пд = АЦе.{051и9(), 
уаг аЧЧедАе: [оса\а{еТАме = [оса\Оа{еТАме.пом(), 
@19 @Сепегафед\Уа\ие уаг 19: 1019? = п 1.) 


@ЕпЕтеу 
СТа$$ Изег( 
уаг 1091п: 5Ег4пд, 
уаг ЕАг${паме: 5%гАлпд, 
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уаг Та5{паме: 5%г\лпд, 
уаг дезсгАр оп: 5%г1п9? = ПЦ, 
@14 @Сепегафед\Уа\ие маг 19: 10п9? = п 1.) 


Классы Агасе и Цзег используют уаг-свойства и даже допускают значение 
пиЦ в поле первичного ключа. На языке НФегпа{е (наиболее известный про- 
изводитель поддержки ]РА) первичный ключ со значением пи 1 (отмеченный 
здесь аннотацией 019) указывает, что экземпляр находится в переходном со- 
стоянии, то есть когда в соответствующей! таблице базы данных нет записи, 
связанной с этим экземпляром. Например, сразу после создания экземпляра 
класса до его сохранения или после удаления записи из базы данных, пока эк- 
земпляр все еще находится в памяти. 

Аннотация @бепега{е\а\ие сообщает, что значения первичного ключа гене- 
рирует сама база данных. 

Вам как разработчику на Кош широкое использование уаг и отсутствие ав- 
томатически сгенерированных функций +05%г4пд, едиа1$ и ВазНСоде может по- 
казаться неудобным. Тем не менее такой подход лучше совместим с РА. Если 
вы используете другой АРТ, основанный на 5рипе Бака, например 5рипз Бака 
МопэорВ или 5рит® Ваёа ОВС, то можете использовать классы данных. 


Смотри также 
Рецепт 12.1, где обсуждается плагин КоНт-5риив. 


12.3. ВНЕДРЕНИЕ ЗАВИСИМОСТЕЙ 


Задача 


Организовать автоматическое связывание компонентов с использованием ме- 
ханизма внедрения зависимостей и объявлять, какие компоненты необходи- 
мы, а какие - нет. 


Решение 


Использовать механизм внедрения в конструктор, поддерживаемый в Кот. Для 
внедрения в поля применять свойства Та{е1п1{ уаг. Необязательные компоненты 
можно объявлять с использованием типов, поддерживающих значение пи. 


Обсуждение 


Связывание компонентов в $рит осуществляется с помощью механизма внед- 
рения зависимостей. Но пусть вас не пугает это название, кажущееся сложным. 
На самом деле все довольно просто. Идея заключается в добавлении ссылки из 
одного типа на экземпляр другого типа, а $р!пе сам найдет способ, как предо- 
ставить экземпляр этого типа. 

По возможности 5рипе использует внедрение в конструктор. В Кош для 
этого можно использовать аннотацию @Аикош\гед для отметки аргументов кон- 
структора. Если в классе имеется только один конструктор, то вам даже не при- 
дется использовать аннотацию @Аифомге4, потому что все аргументы един- 
ственного конструктора будут связываться автоматически. 
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Если в компоненте эрипя имеется только один конструктор, то 
эрипя автоматически внедрит все аргументы. 


Допустим, что у вас есть контроллер КЕЗТ; который должен взаимодейство- 
вать с внедряемой службой. Организовать‘автоматическое внедрение можно 
с помощью любого из подходов, показанных вримере 12.5. 


Пример 12.5. Автоматическое внедрение зависимости в 5рИпд 


@ВеСопгоДег ® 
СТа$$ бгее{1паСоп&гоЦег(\уа1 зегу1се: Сгее\пабегу1се) { /*... */ } 


@Ве${СопгоДег ®@ 
С1а$$ Сгее{1паСоп&гоДег (@АцфомАгеф \уа{ зегу1се: бгее{лпдбегусе) { /*... */ } 


@Ве${СопгоДег ® 
С1а$$ Сгее{\паСоп&гоДег @АифомАгеф сопзЕгисфог(\а| зег\у1се: Сгее{Апдбегу се) { 
// ... (обычный отступ с 4 пробелами) 


} 


@ВезСопгоДег @ 
С1а$$ Сгее1паСоп&гоДег { 
@Ацфомлгед 
Тафе1пА{ уаг зегу1се: Сгее\пабегу1се 


ПА ава 


© 
|2) 
© 


о 


остальная часть определения класса ... 


Вариант 1: класс с единственным конструктором 
Вариант 2: явное автоматическое связывание 


Вариант 3: ВЫЗОВ конструктора автоматического связывания, этот прием 
используется в основном для классов с несколькими зависимостями 


Вариант 4: внедрение в поле (не самый лучший, но вполне работоспо- 
собный способ) 


В этом примере показаны все способы внедрения зависимостей: 


©) 


о 


©) 


просто объявить зависимоёти; в классе с единственным конструктором 
все зависимости будут подключены автоматически; 

явно использовать аннотацию @Аифом\гед, которая действует точно так же, 
но явная аннотация @Аифом\гед продолжает работать, даже если в класс 
добавить вторичный конструктор; 

добавить аннотацию @Аикон\гед перед функцией соп5{гистог. Обычно этот 
прием используется как упрощенный вариант, когда требуется внедрить 
несколько зависимостей; 

наконец, если по каким-то причинам необходимо организовать внедре- 
ние в поле, можно определить поле с модификаторами Та{е\лпА{ маг. 


Поскольку свойства уа\ должны получать значение при объявлении, их нель- 
зя инициализировать значениями, определяемыми позже. Вот почему ключе- 
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вое слово Та{е\пА{ используется с маг. Недостаток этого способа состоит в воз- 
можности изменить свойство уаг в любой момент, а это может быть не совсем 
то, что вам нужно. Это одна из причин, почему внедрение в конструктор пред- 
почтительнее. 

Если свойство класса является необязательным, его можно объявить с ти- 
пом, допускающим значение пи 1. Например, рассмотрим функцию в бгее*4пд- 
СопегоДег, которая генерирует приветствие из необязательного параметра за- 
проса, как показано в примере 12.6. 


Пример 12.6. Функция контроллера с необязательным параметром 


@СеЕМаррАпд(« /Ве1о») 
Рип дгее{0сег(@Ведиез{Рагат пате: 5%г1пд?) = 
Сгее{Апд(зег\у1се.зауНео(пате?: “Мог14”)) е\зе Сгее{лпд() 


Объявив параметр паме как допускающий значение пи\1 (например, с типом 
51г1пд? вместо 5{г1пд), мы сообщаем компилятору Кот, что параметр являет- 
ся необязательным. 

Фреймворк $рипе также поддерживает использование Фий 5 для тестиро- 
вания. Вот две особенности ий 5, не поддерживаемые в /Фпи 4: 


О втестах ий 5 можно определять конструкторы, отличные от конструк- 
торов по умолчанию; 

О управляя жизненным циклом тестового класса, можно создавать один 
экземпляр для класса в целом, а не для каждого его метода. 


В примере 12.7 показан фрагмент теста из учебника Ко т/5рипе. 


Пример 12.7. Внедрение зависимостей с использованием аргументов конструктора в пи 5 


(@Бафа)раТе$+ 

СТаз$ Керо$\КоглезТез{$ @АифоиАгед соп$гисфог( 
уа1 еп{\{УМападег: Тез{Еп\уМападег, 
уа\ изегВеро$\{огу: ЦзегВеро$\Когу, 
уа1 аг{1с1еверо$\{огу: Аг с1еКеро$\{огу) { 


// ... здесь следуют определения тестов ... 


] 


// Другой тест, использующий 5рг\пд-класс Вез{Темр1а{е 
@бргАпоВоо{Тез{(мерЕпу\гоптепе = ЭргАпдоВоо{Тез*.мерЕпу\гоптепе.ВАМООМ_РОВТ) 
СТаз$$ Тп{едга\опТез{$ (@Аифоилгед \уа{ гез{Тетр\афе: Тез{Вез+Тетр1а*е) { 

// ... здесь следуют определения тестов ... 


} 


При использовании варианта с аннотацией @Аицкожгед перед функцией соп- 
з+гисеог не требуется использовать свойства 1а%е1п\е \уаг. В первом случае, 
с классом Вероз\ог\1езТез+{$, производится автоматическое внедрение экземп- 
ляров пользовательских классов. Во втором случае, с классом Тп{едгаопТез+$, 
производится запуск тестового сервера на случайном порту, на котором раз- 
вертывается веб-приложение, а затем используется класс Тез+Ве{Тетр\а{е (ко- 
торый уже настроен с соответствующим портом) для выполнения запросов 
ВЕЗТ с применением таких функций, как дееРогОБес* или деЕРогЕпе\\у. 


пав 4.5 


Сопрограммы 
и структурированная 
конкуренция 


Одной из самых популярных особенностей Кот является поддержка сопро- 
грамм, которые дают возможность писать код, выполняющийся конкурентно, 
как если бы он был синхронным. Эта поддержка упрощает написание конку- 
рентного кода, использующего сопрограммы, по сравнению с другими метода- 
ми, такими как обратные вызовы или реактивные потоки. 

Обратите внимание: ключевое слово здесь «упрощает», а не «просто». Управ- 
ление параллельным выполнением всегда было сложной задачей, особенно 
когда требуется координйровать несколько разных действий, обрабатывать 
отмену и исключения и многое другое. 

В этой главе рассматриваются вопросы, связанные с использованием сопро- 
грамм в Кот. К их числу относятся: определение области видимости и кон- 
текста сопрограммы, выбор подходящих функции запуска и диспетчера сопро- 
грамм, а также управление их поведением. 

Сопрограммы - это фрагменты кода, которые можно приостанавливать 
и возобновлять. Отмечая функцию ключевым словом зизрепа, вы сообщаете си- 
стеме, что она может временно приостановить выполнение функции и возоб- 
новить ее позже в другом потоке выполнения, и при этом вам не нужно писать 
сложный многопоточный код. 


15.1. ВЫБОР ФУНКЦИИ ЗАПУСКА СОПРОГРАММ 


Задача 
Выбрать подходящую функцию для создания сопрограммы. 


Решение 


Сделать выбор между несколькими доступными функциями запуска сопро- 
грамм. 
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Обсуждение 


Создать новую сопрограмму можно с помощью одной из доступных функций за- 
пуска: гипВ1осКАлпд, ТацпсВ и азупсаНервая из них -— гипВ1осК\пд — является функцией 
верхнего уровня, а Таипсв и азупс/ это функции-расширения для Согои\пебсоре. 

Прежде чем перейти к изучёнию приемов их использования, важно отме- 
тить, что существуют также версии Таипсй И азупс для класса С1оБа15соре, пользо- 
ваться которыми не рекомендуется, если в этом нет абсолютной необходимо- 
сти. Дело в том, что эти функции запускают сопрограммы, не привязанные 
к какой-то конкретной задаче, и охватывают весь жизненный цикл приложе- 
ния, если их не отменить преждевременно. Поэтому старайтесь не использо- 
вать их без веской на то причины. 


Этот раздел можно было бы озаглавить как «Выбор функции запуска 
сопрограмм, за исключением С1оба!5соре.1аипсВ». 


Функция гипВ[осК9 


Функция гипВТосК\лпд — одна из рекомендуемых функций запуска сопрограмм - 
может пригодиться для демонстрации из командной строки или в тестах. Как 
можно догадаться по ее имени, она блокирует текущий поток и ждет заверше- 
ния всех запущенных сопрограмм. 

Вот как выглядит сигнатура функции гипВ1осК\лпд: 


Рип <Т> гипВТоск1па (Боск: зизрепд Согоцлпебсоре.() -> Т): Т 


Функция гипВ81осКпд сама по себе не является функцией, доступной для при- 
остановки, поэтому ее можно вызывать из обычных функций. Она принимает 
аргумент с функцией, доступной для’приостановки, добавляет ее как функ- 
цию-расширение в Согоипебсоре, запускает и возвращает любое значение, 
возвращаемое этой функцией. 

Как показано в примере 13.1, использовать гипВ\оскК\Апд довольно просто. 


Пример 13.1. Использование функции гипВ®ск19 


АтрогЕ Ко{11пх. согоц Апез .де\ау 
АтрогЕ Ко{14пх. согои 1пез . гипВ1осК1пд 


ип пафп() { 
ргАп1п(“Веоге сгеа пд согои пе”) 
гипВТосК\па { 
рглпЕ(“НеДо, “) 
де\ау(2001) 
рп п (“Мог19!”) 


ргАп п(“АЁег согоц пе 1$ РАпаред”) 


Этот код выведет следующее: 


ВеРоге сгеа{пд согои пе 
Нео, Мог19! 
АЁЕег согоч пе РАпл$Нед 


х. 
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Но обратите внимание, что между выводом «Нео» и «МЛойа} имеет место 
200-миллисекундная задержка. 


Функция [аипсп 


Чтобы запустить сопрограмму, выполняющую отдельный процесс и ничего 
не возвращающую, можно использовать функцию Таипсй. Функция Таипсв — 
это функция-расширение для СогоиАпебсоре, поэтому ее можно использовать, 
только если доступен экземпляр Согои 1 пебсоре. Она возвращает экземпляр 205, 
который можно использовать для отмены сопрограммы. 

Вот как выглядит сигнатура функции Таипсй: 


Рип Согои1лпебсоре. ТаипсВ( 
сопех&: СогоипеСопфехЕ = Емр%уСогоиАпеСоп\ех+, 
5фаг&: СогочпебфагЕ = Согоц&Апеб%аг*.БЕРАЦЕТ, 
ЫосК: зизреп@ Согоипебсоре.() -> Уп 

): 306 


Экземпляр СогочлпеСоп{ехе представляет состояние, совместно использу- 
емое несколькими сопрограммами. Согоц{лпеб{аг{ — это класс-перечисление, 
включающий значения ОЕРАЦЕТ, 1А7УГАТОМТС и ИМОТ5ЗРАТСНЕО. 

Лямбда-выражение Б1оск должно быть функцией, допускающей приостанов- 
ку, не принимающей аргументов и ничего не возвращающей. В примере 15.2 
показано, как использовать функцию Таипсй. 


Пример 13.2. Использование функции [аипсй 


АтрогЕ Ко{11пх. согои 1 пез .де\ау 
АтрогЕ Ко{11пх. согои А лпе$. ТацпсВ 
АтрогЕ Ко{14пх. согои1ле$ . гипВ1оскК\пд 


Рип пафп() { 
ргап п (“Вегоге гипВТосК\пд”) 
гипВТосК\па { 
рглп 1лп( "ВеФоге ТаипсН") 
ТаипсН { 
ргАпЕ("НеДо, ") 
де\ау(2001.) 
ргАп п ("Мог а! ") 


рглп 1лп("АЁфег Таипсй") 


ргАп1п("АЁег гипВТосКАпд") 


© Создание области видимости сопрограмм 
@ Запуск сопрограммы 


Этот код выведет следующие строки: 


ВеРоге гипВТосК\пд 
ВеРоге Таипсй 
АЁЕег Таипсв 
Нео, Иог19! 
АЁЕег гипВТосКАпд 
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И снова между выводом «Не!о» и «М/о! а!» имеет место 200-миллисекундная 
задержка. 
Порядок отмены возвращаемогоззадания 206 демонстрируется в примере 13.5. 


Функция азупс 


В обычной ситуации, когда нужно вернуть значение, используйте функцию 
азупс. Это тоже функция-расширение для Согочпебсоре, и вот как выглядит ее 
сигнатура: 
ип <Т> Согои\пебсоре. азупс( 

сопех&: Согои\пеСоп{ехЕ = Емр%уСогоиАпеСоп\ех+, 

$фаг{: Согоупеб+агЕ = СогоцАпеб{аг*.БЕРАЦЕТ, 


ЫосКк: зизрепЧ Согоч1пебсоре.() -> Т 
): Бефеггед<Т> 


И снова параметры СогочпеСоп{ех* и Согои1пеб{аг* имеют разумные значе- 
ния по умолчанию. 

На этот раз функция, поддерживающая возможность приостановки, возвра- 
щает значение, которое функция азупс заключает в экземпляр Ое{еггеч. Экземп- 
ляр Ое{еггед действует подобно объекту Ргомзе в ]ауабсире или Еифиге в ]Лауа. 
Важно помнить, что Ое{еггед имеет функцию ама\{, которая ожидает заверше- 
ния сопрограммы и возвращает произведенное ею значение. 

В примере 13.5 показано, как использовать азупс. 


Пример 13.53. Создание сопрограммы с помощью азупс 


АтрогЕ Ко{14пх. согои пез .азупс 

АтрогЕ Ко{14пх. согои1пез . согоу1пебсоре 
1трогЕ Ко{11пх. согои{ Апез .де\ау 

АтрогЕ Ко{14лп.гапдом.Вапдом 


$и5репд Фип а49(х: Тпе, у: Тп®): Ти { 
де\ау(Вапдот. пех 1оп9(10001)) © 
гебигп х + у 


} 
$и5реп4 Фип ма1п() = согоилпебсоре { [2] 
уа1 ЕАг$Е5им = азупс { [3] 
рглп 1л(ТБгеад. сиггепЕТВгеа9() .паме) 
а49(2, 2) 
} 
уа\ зесоп@5им = азупс { [3] 
ргАп 1л(ТВгеад. сиггепЕТВгеа4() .паме) 
а99(3, 4) 
} 


ргАп п("Аиа\п9 сопсиггепЕ $им5...") 
уа1. сота\ = ЕАгз&бит.ама\{() + зесоп4д5им.аиа\{() ® 
ргАп1п(“Тофа1 1$ $%0%а1”) 


Случайная задержка до 1000 мс 
Еще одна функция запуска сопрограмм, обсуждаемая далее в этом рецепте 
Использование азупс для запуска сопрограммы 


о<фоФ®е 


Вызов ама\т+, чтобы дождаться завершения сопрограммы 
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Функция а44 приостанавливает выполнение на случайное время до 1000 мс, 
а затем возвращает вычисленную сумму. Два вызова азупс запускают функцию 
а94 и возвращают экземпляры Ое{еггед. Вызовы ана\* блокируют выполнение 
главного потока до завершения сопрограмм. 

Вот результаты выполнения этого кода: 
ОеРаи {04 5рафсвег-иогКег-2 
Ама11п9 сопсиггепе $им$... 


ВеРац1{0\.5рафсНег-могКег-1 
Тофа\ 1$ 11 


Обратите внимание, что функция деау =. это функция с поддержкой воз- 
можности приостановки, которая переводитвопрограмму в режим ожидания, 
не блокируя потока, в котором она выполняется. 

Два вызова функции азупс используют диспетчер по умолчанию - один из 
обсуждаемых в рецепте 13.3. Вызов гип8осКАпд будет ждать завершения всех 
запущенных сопрограмм. Порядок вывода строк зависит от случайно сгенери- 
рованных задержек. 


Функция согоите$соре 


Наконец мы добрались до функции согои{пебсоре. Она также поддержи- 
вает возможность приостановки и ждет завершения всех запущенных со- 
программ перед выходом. Ее преимущество в том, что она не блокирует 
основной поток (в отличие от гипВТосК1па), но должна вызываться как часть 
зизреп9-функции. 

Это подводит нас к одному из фундаментальных принципов - сопрограм- 
мы должны выполняться в определенной области видимости. Преимущество 
согои1пебсоре заключается в отсутствии необходимости вручную определять, 
завершились ли сопрограммы, - она автоматически ждет завершения всех до- 
черних сопрограмм. 

Вот как выглядит сигнатура функции согоч А пебсоре: 
$и5реп4 Фип <В> согоч\лпебсоре( 

ЫосК: зизреп@ Согои\пебсоре.() -> В 
): В 

Как видите, функция принимает лямбда-выражение (с приемником Со- 
гои{пебсоре) без аргументов и возвращает обобщенное значение. Функция 
поддерживает возможность приостановки, поэтому должна вызываться из 
другой функции с поддержкой приостановки или из другой сопрограммы. 

Простой пример использования согои\пебсоре показан непосредственно на 
домашней странице Кот (БИр://копапя.оге/) и в примере 13.4. 
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Пример 13.4. Использование функции согоийте$соре 


АтрогЕ Ко{14пх. согои1пе$ . согоу1пебсоре 
АтрогЕ Ко{14пх. согои пез .де\ау 
АтрогЕ Ко{14пх. согои пез. 1аипсВ 


зузреп@ Фип ма1п() = согои А пебсоре { ® 
Фог (14 0 шт 10) { 


ТаипсВ { [2] 
Че\ау(1000. - 1 * 10) [3] 
ргАпе( "$ “) 
} 
} 
} 
© Функция согош А пебсоре 
@ Запуск 10 сопрограмм 
9 Постепенно уменыпающаяся задержка перед запуском очередной со- 


программы 


Этот пример запускает 10 сопрограмм, перед каждой из которых выполня- 
ется задержка на 10 миллисекунд меньше, чем перед предыдущей. В результа- 
те выводится последовательность сердечек и чисел в порядке убывания: 


9 9; 97 $5 95 94 Ф: 92 9! 5 


В этом примере показан общий шаблон: сначала вызывается согои{пебсоре, 
чтобы создать область видимости для сопрограмм, а внутри получившегося 
блока вызываются функции Таипсй ИЛИ азупс для запуска конкретных сопро- 
грамм. После этого область видимости будет ждать завершения всех сопро- 
грамм, а если какая-либо из сопрограмм завершится аварийно, то отменит все 
остальные. Это обеспечивает хороший баланс между управлением и обработ- 
кой ошибок, не требуя проверять - продолжают ли выполняться сопрограммы, 
и предотвращает утечки в случае сбоев. 


Соглашение о запускезвсех сопрограмм внутри согоилпебсоре, гаран- 
тирующее остановку всех в случае сбоя одной, известно как структу- 
рированная конкуренция (гисгагеа сопситепсу). 


Сопрограммы могут вызывать сложности при рассуждении о порядке вы- 
полнения кода, потому что в этом механизме очень много движущихся частей 
и очень много возможных комбинаций. К счастью, на практике используется 
лишь несколько комбинаций, которые были показаны в этом рецепте. 


13.2. ЗАМЕНА АЗУМС/АМАТ НА УИТНСОМТЕХТ 


Задача 


Упростить код, запускающий сопрограмму с помощью азупс и затем просто 
ожидающий ее завершения с помощью ама\*. 


х. 
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Решение 
Заменить комбинацию вызовов азупс И ама\{ вызовом и\ЕНСопфех+. 


Обсуждение 


Для класса Согоц А пебсоре имеется еще одна функция-расширение - и\Сопкех%. 
Вот ее сигнатура: 


$и5реп4 Фип <Т> и НСопфех{( 

сопфехе: СогоипеСопфехе, 

ЫосК: зизреп@ Согоупебсоре.() -> Т 
): т 


В документации говорится, что иАЕАСопфех* «вызывает указанный блок с за- 
данным контекстом сопрограммы, приостанавливается до завершения этого 
блока и возвращает результат». На практике и\АСоп{ех* используется для за- 
мены комбинации вызовов азупс И ама\{, как показано в примере 153.5. 


Пример 13.5. Замена комбинации вызовов азупс-и‘ау/ай вызовом \/ИПСогиехЕ 


зизреп4 Фип гефг1еуе1(иг1: 5%г4пд9) = согои 1 пебсоре { 
азупс(О45раесвег$.10) { 
рглп п(“Вефг\1ем1па Чафа оп ${ТВгеад. сиггеп&ТАгеа4() .пате}”) 
Че\ау(1001) 
“азупсВе$и1+5” 
}.амале() 
} 


зизреп4 Фип гефг\1еуе2 (иг1: 5%г4пд) = 
маЕНСопеехЕ (015раесвег$.10) { 
рглп п(“Вефг\еу1па Чафа оп ${ТВгеа4. сиггеп&ТАгеа4() .пате}”) 
е\ау(1001) 
“итЕАСопеех{Вези 1+5” 


} 


Рип пафп() = гипВТосК\п9<Ип\+> { 
уа1 гези1{1 = гефгле\уе1 (“имм.туз\е. сот”) 
уа\ гези1{2 = гесглеуе2 (“ими .пуз\Ке . сом”) 
ргап п (“рг1пЕ1 пд геи оп ${ТИгеад. сиггепЕТВгеа9(0)..пате} $гези1{1”) 
ргап п (“рг1пЕ1 пд геи оп ${ТИгеад. сиггепТАгеа():пате} $гези\{2”) 


Функция ма1п начинается с вызова гипВ1осК\Апд, что тоже типично для такой 
простой демонстрации. Две функции, ге{г1еуе1 и геег\1еуе2, делают одно и то же: 
приостанавливаются на 100 миллисекунд и затем возвращают строку. Запус- 
тив этот код, я получил следующие результаты (обратите внимание, что у вас 
порядок вывода строк может быть другим): 

Вефг1е\1пд Чафа оп БеРац {О0\5рафсНег-могКег-2 
Вефг1е\1пд Чафа оп БеРац {О\5рафсНег-могКег-2 


ргАп1пд гези\Е оп мафп мА НСопеех{Вези {$ 
ргАп1пд гези\ оп мафп азупсВе$и1 15$ 


Обе функции используют диспетчера 015ра{спег$.10 (обсуждается в рецеп- 
те 13.5), поэтому они отличаются только тем, что одна использует комбина- 
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цию азупс/аиа1*, а другая заменяет ее вызовом и\НСопех{. Фактически, когда 
среда разработки шие] ШЕА видит, что в коде за вызовом азупс сразу же сле- 
дует вызов ама\1+, она предложит заменить эту пару вызовом и\НСопфех{ и сде- 
лает это за вас, если вы разрешите. 


15.5. ДИСПЕТЧЕРЫ 


Задача 


Использовать выделенный пул потоков выполнения для ввода/вывода или 
других задач. 


Решение 
Использовать подходящего диспетчера из класса О\зрасвег$. 


Обсуждение 

Сопрограммы выполняются в контексте, определяемом типом Согоц\пеСопкехе, 
который включает диспетчера сопрограмм, представленного экземпляром 
класса Согоцпе0\ратсвег. Диспетчер определяет, какой поток или пул потоков 
выполнения использовать для выполнения сопрограмм. 

При использовании функции запуска сопрограмм, такой как Таипсй или азупс, 
можно явно указать тип диспетчера для использования, передав необязатель- 
ный параметр Согоц\пеСоп\ехе. 

Вот список встроенных диспетчеров, предлагаемых библиотекой: 


О П\раксвег$.ОеФац\*; 
О П\брафсвег$.10; 
О П\браесвег$.УпсопАлпед. 


Последний обычно не рекомендуется использовать в прикладном коде. 

Диспетчер Бега 1+ использует общий пул фоновых потоков выполнения. 
Он подходит для сопрограмм, потребляющих большой объем вычислительных 
ресурсов. 

Диспетчер 10 использует общий пул потоков выполнения, создаваемых по 
требованию, и предназначен для операций ввода/вывода, активно использую- 
щих блокировки, таких как операции с файловой системой или сетевой ввод/ 
вывод. 

Диспетчеры довольно просты в использовании. Достаточно передать под- 
ходящего диспетчера функции Таипсп, азупс или и НСопфех+, как показано в при- 
мере 153.6. 


Пример 13.6. Использование диспетчеров Бе{аий и 10 


Рип пафп() = гипВТосКАп9<ИУп\+> { 
Тацпс Ви ЕВТО() 
Таипс и ЕРОеРаи1*() 
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зизреп4 Фип ТаипсПИУЕВТО() { 
маЕНСопеехЕ (015раесвег$.т10) { © 
е\ау(1001) 
ргап п ("У$1п9 О1зраесВег$. ТО") 
рглп 1п(ТБгеад. сиггепЕТВгеа4() .паме) 


} 


$и5реп4 Фип ТацпсНИ\ЕНОе аи {() { 
мтЕНСопфех{ (О1зраесНег$ .ОеРац{) { [2 
Че\ау(1001) 
ргАп Е 1п("У$1па О15расВег$ .Бегац\ +") 
рглп п (ТБгеад. сиггепЕТВгеа9() .паме) 


} 


© Диспетчер 10 
@ Диспетчер Бега 


Вот результат выполнения этого примера (у вас номера рабочих ПОТОКОВ МО- 
гут отличаться): 
($1п9 О1зрафсвег$.10 
ОеГау1 {01 5рафсвег-имогКег-3 


0$1п9 О1зрафсвег$ .ОеРац 
БеРаиц1{0\.5рафсвег-могКег-2 


Запуская сопрограммы, можно указать любого диспетчера. 


В некоторых руководствах предлагается использовать функции 
пем51п91еТАгеадСопфех*е и пемЕАхедТНгеаЧРоо\Соп{ех{ для создания дис- 
петчеров. В настоящее время обе считаются устаревшими и будут 
заменены в будущем. Вместо них можно использовать функцию 
а$Согои А пе) 5рафспег из ]ауа-класса Ехесифог5ег\Асе, как описано да- 
лее в этом рецепте. 


Диспетчеры в Апаго!а 


Кроме уже рассмотренных диспетчеров, Апаго!а АР] предлагает также диспет- 
чера О\5ратсВег$ .Ма\л. Обычно он используется для реализации инструментов 
пользовательского интерфейса, задачей которых является обновление поль- 
зовательского интерфейса в Ма\п, но выполняющих работу, которая может вы- 
звать дополнительные задержки в Ма\п. 

Чтобы получить диспетчера Ма1п в Апаго!4, необходимо подключить зависи- 
мость Ко 14 пх-согоц пез -апдго\ 4. Вот как это выглядит в файле сборки Ста@е: 
ерепдепс\е$ { 


1пр\емепфа оп “огд. )е{Бга\пз .Ко1Апх: Ко А пх-согоц1пе$-соге:х.х.х” 
1тр\етепфа{1оп «огд. ]е{Бга\л$ Ко пх: Ко Алхзсогои пез -апдго\9:х.х.х» 


Здесь значения х.х.х следует заменитыЫномером последней версии. 

Библиотека компонентов Апаго! также включает несколько дополнитель- 
ных диспетчеров жизненного цикла. Подробности ищите в описании библио- 
теки Апаго14 КТХ, в частности в описании реализации \АРесус1е-у1еитоде\. Фак- 


202 4+ Сопрограммы и структурированная конкуренция 


тически Апаго!4 часто рекомендует запускать сопрограммы с использованием 
у1емМоде\5соре из этой библиотеки. 


Смотри также 


Рецепт 13.4, где обсуждается служба исполнения в ]ауа, которая предлага- 
ет своих диспетчеров сопрограмм. Рецепт 13.5, где обсуждаются диспетчеры 
Апаго!а. 


15.4. ЗАПУСК СОПРОГРАММ В ПУЛЕ ПОТОКОВ ЛАМА 


Задача 
Создать СВОЙ пул потоков для выполнения сопрограмм. 


Решение 
Использовать функцию азСогои{1пе0\зра%сВег в ]ауа-классе Ехесифог5егу4се. 


Обсуждение 


Библиотека Кот определяет метод-расширение для 3ауа. и... сопсиггеп*.Ех- 
есифог5егу1се с именем а$Согои*1пе0\зраесвег. Как сказано в документации, эта 
функция преобразует экземпляр Ехесифог5ег\Асе в реализацию ЕхесиогСогои Ап- 
е0\5ратсвег. 

Чтобы использовать его, нужно с помощью класса Ехесихог$ определить пул 
потоков, а затем преобразовать его для использования в роли диспетчера, как 
показано в примере 13.7. 


Пример 13.7. Использование пула потоков выполнения в роли диспетчера сопрограмм 


АтрогЕ Ко{14пх. согои пез . азСогои пе) рафсВег 
АтрогЕ Ко{11пх. согои{ пез .де\ау 

АтрогЕ Ко{14пх. согои 1лпе$ .гипВ1осК\п9 

АтрогЕ Ко{14пх. согои 1 пез . и ЕВСопеехе 

1трогЕ )а\уа. и 11. сопсиггеп{ . Ехесиог$ 


Рип пафп() = гипВТосКАп9<ИУп\+> { 
уа\ ЧАзраесвег = Ехесиког$ .пемРАхедТАгеааРоо1.(10) ® 
„а$Согои1пеб\рафсвег() 


маЕНСопфехЕ (915раеспег) { @ 
Че\ау(1001) 
рглп 1л(ТВгеад. сиггепЕТВгеа4() .паме) 

} 

ЧАбра%сВег.с1о$е() [3 


© Создание пула с 10 потоками выполнения 
@ Использование пула в роли диспетчера сопрограмм 
© Остановка пула потоков 


15.4. Запуск сопрограмм в пуле потоков }ауа %* 205 


Этот код выведет роо\-1-{Агеа9-2, сообщая, что система запустила сопро- 
грамму в потоке 2 пула 1. 

Обратите внимание на последнюю строку в этом примере, которая вызывает 
функцию с1озе диспетчера. Это необходимо, потому что иначе служба исполне- 
ния будет продолжать работать, а значит, функция па\л никогда не завершится. 

Предыдущий прием также является интересной иллюстрацией, как в Ко/т 
решаются подобные проблемы. Обычно, чтобы остановить ]ауа-класс Ехеси- 
фогбегу\се, вызывается метод $Ни{домп или $НиЧомп№ и. Поэтому пример можно 
переписать, сохранив ссылку на Ехесикогбегу4се и останавливая его вручную, 
как показано в примере 153.8. 


Пример 13.8. Остановка пула потоков выполнения вручную 


уа\ роо| = Ехесифог5егу\1се .пемЕлхедТАгеа4Роо\ (10) 
итЕВСоптехЕ (роо1..азСогоипе0\зраесвег()) { 
|... тот же код, что и прежде... 


роо\.. Ви Чомп() 


Проблема этого подхода заключается в том, что пользователь может забыть 
вызвать метод зи доип. В ]ауа подобные проблемы решаются путем реализации 
интерфейса АикоСТозеа Ле с методом с\1озе, что позволяет заключить код в блок\ту- 
м -гезоигсез. К сожалению, здесь требуется вызвать метод зНидоилт, а не с1озе. 

По этой причине разработчики библиотеки Кот внесли изменения в ба- 
зовый класс ЕхесикогСогои1пед\расвег, экземпляр которого создается в пре- 
дыдущем коде. Они реорганизовали его и реализовали интерфейс С1озеаБе, 
назвав новый абстрактный класс С1озеаБЛеСогоч+Апе0\рафсвег, чей метод с1о5е 
выглядит, как показано ниже: 


АтрогЕ )а\уа. и 11. сопсиггепе .Ехесиког5егу%се 


аб$ЕгасЕ с1аз$$ ЕхесифогСогои 1пей\раесвег: Согои\пеб\раесВег(), С1озеаЩе { 
абз%гасЕ оуеггАде Кип с1о$е() 
аб$гасе уа1 ехесифог: Ехесибог 


} 


// Далее в подклассах: 
о\уегг14е Фип с1о$е() { 

(ехесифог а$? Ехесифог5егу\1се)? . Ви домп() 
} 


Это означает, что диспетчеры, созданные с помощью службы исполнения, 
сейчас имеют функцию сТозезкоторая останавливает службу исполнения. Те- 
перь возникает вопрос: как/обеспечить вызов функции с1озе, учитывая, что, 
в отличие от ]ауа, язык КоШя'не ноддерживает конструкцию {ту-мМИ-гезоигсез? 
В Кот есть функция це. Ее определение показано в примере 13.9. 


Пример 13.9. Функция изе 
АпИле Фип <Т : С1озеаБЛе?, В> Т.изе(БЛоск: (Т) -> В): В 
Как видите, изе определяется как функция-расигирение для ]ауа-интерфейса 


СТозеае. Это дает прямое решение проблемы остановки службы исполнения 
в [ауа, как показано в примере 13.10. 
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Пример 13.10. Автоматическое завершение диспетчера с помощью изе 


Ехесифог$ .пемРАхедТВгеаЧРоо1(10).азСогочц пе) ра&сВег().изе { 
мАЕНСопеехЕ (14) { 
е\ау(1001) 
ргАп Ел (ТВгеад. сиггепТЬгеа4( ) .пате) 


Этот код закроет диспетчера, как только блок чзе достигнет конца, который, 
в свою очередь, остановит пул потоков выполнения. 


Смотри также 
Рецепт 10.1, где описывается функция изе. 


15.5. ОТМЕНА СОПРОГРАММ 


Задача 
Остановить асинхронный процесс, выполняемый в сопрограмме. 


Решение 


Использовать ссылку на экземпляр 206, которая возвращается функцией Таипсй, 
или запускать сопрограммы с помощью таких функций, как мА АТА меоц{ и мВ - 
ТАмеоцОгМи 11. 


Обсуждение 


Функция Таипсв возвращает ссылку на экземпляр типа 7206, с помощью которого 
можно прервать выполнение сопрограммы. В примере 15.11 приводится код, 
взятый из справочного руководства по Кот. 


Пример 13.11. Отмена задания 


Рип пафп() = гипВТосКАпд { 
уа1 ]оБ = Таипсв { 
гереа*(100) {1 -> 
ргап п (“)о6: Т’м миа лад $1...”) 
де\ау(1001.) 


} 
де\ау(5001.) 
ргап п(“та\п: ТРа{’$ епочаН ма Ел”) 
Эо6 .сапсе\() 
306. )01п() 
ргАп п(“тафп: Обопе”) 


Функция Таипсв возвращает ссылку на экземпляр 205, которая сохраняет- 
ся в локальной переменной. Затем с помощью функции гереа{ запускается 
100 сопрограмм. 

После выхода из блока Таипсй функция пма\л спустя какое-то время решает 
отменить задание. Функция )0о\1п ждет завершения задания, а затем программа 
завершается. Вот как выглядит вывод этой программы: 


х. 


15.5. Отмена сопрограмм % 205 


306: Т'м ма лд 0... 

306: Т'м ма лд 1... 

306: Т'м мала 2... 

306: Т'м ма Алд 3... 

306: Т'м ма лд 4... 

па\п: ТВа*'$ епочаВ иа\{Алп9 
па1п: Оопе 


Существует также-функция сапсе\Ап92о\п, которая объединяет в себе 
сапсе\ и )о1п. 


Если основной причиной отмены задания является превышение некоторого 
времени, то для запуска сопрограмм можно использовать функцию и ВТА меоц*. 
Вот сигнатура этой функции: 
$и5реп4 Фип <Т> ил НТА леоц*( 

Алем 15: 1опд, 
ЫосК: зизреп@ Согоипебсоре.() -> Т 
): т 

Функция запускает блок кода внутри сопрограммы и генерирует исключе- 
ние Т\меоц{Сапсе Па 1опЕхсер Топ, если время его выполнения превысит установ- 
ленный предел. В примере 13.12 показано, как использовать эту функцию (и 
снова код для примера взят из справочного руководства). 


Пример 13.12. Использование функции М\УИНТитеоц( 


Рип ма\л() = гипВ\осК\лд { 
мАЕНТлеоц{ (1000) { 
гереа*(50) {1 -> 
ргАпп(«)06: Т'м мала 5$1...») 


Че\ау(1001) 
} 
} 
} 

Этот пример выведет: 
306: Т'м мала 0.. 
306: Т'м мала 1.. 
306: Т'м мала 2.. 
306: Т'м ма Алд 3.. 
306: Т'м мала 4.. 
306: Т'м ма\Алд 5.. 
306: Т'м ма лд 6.. 
306: Т'м ила 7.. 
306: Т'м ма Алд 8.. 


306: Т'м ма лпд 9... 

Ехсер\оп 1п {Пгеа «тафп» Ко 1Апх. согоц пез .ТАмеоцСапсеДа1опЕхсер\оп: 
Т\меф оц мата Рог 1000 пз 

ае Ко Апх. согои А пез .ТАтеоцЕ КЕ. ТАмеоц{Сапсе Ла 1опЕхсер\оп(ТАмеоц{.К{:126) 
// ... остальная часть трассировки стека... 


206 «*% Сопрограммы и структурированная конкуренция 


Это исключение можно перехватить и обработать. Точно так же можно ис- 
пользовать функцию и ЁТАтеоц0гМи, которая не генерирует исключение, 
а просто возвращает пи 11, если будет превышен порог времени выполнения. 


Отмена заданий в Апаго!а 


В Апаго! имеется дополнительный диспетчер ПАзрафсвег$ .Ма\п, который рабо- 
тает с потоком пользовательского интерфейса. Типичный способ его исполь- 
зования - реализовать СогоиАпебсоре в Ма\пАс{ мфу, предоставить контекст, ког- 
да это необходимо, а затем закрыть его, если потребуется. Типовая реализация 
данного подхода показана в примере 13.13. 


Пример 13.13. Использование диспетчеров в Апаго!а 


С1а$$ Ма1пАсА\АЕу : АррСотраЕАс АУ у(), Согоипебсоре { 
оуегг\14е уа1 согоцЕАпеСопфехе: Согои{лпеСог(ехе ® 
9е*() = ОАзраесвег$ .Мафл + )оБ 


рг\уаее Тафе1п1{ маг )о6: 206 [2] 


оуегг\14е Фип опСгеате (зауеЧТпапсеб{ае! (Вип е?) { 
зирег.опСгеате (зауеЧТп{апсезате) 
306 = 3°05() 0 
} 


оуегг\14е Рип оп0езЕгоу() { 
Зо6.сапсе\() [4] 
5ирег.оп0е${гоу() 


- 


© Создание контекста с помощью перегруженного оператора р1и$ 

@ Это свойство будет инициализировано по готовности значения для него 

© Собственно инициализация свойства 

@ Отмена задания с разрушением пользовательского интерфейса 
Использование переменной 106 с отложенной инициализацией обеспечива- 

ет ее доступность на случай отмены. Теперь достаточно просто запускать со- 

программы по мере необходимости, как показано в примере 153.14. 

Пример 13.14. Запуск сопрограмм в Апаго!а 


Рип 4А5р1аубака() { 


Тацпсй { 0 
уа\ Чака = азупс(О\раесНег$.10) { @ 
// ... получить данные из сети... 
ирдафед\$р1ау(Чаа.ама\*()) [3] 

} 


© Запуск с использованием свойства согоипеСопеех{ 
@ Выбор ПА ратспег$.10 для выполнения сетевого вызова 
© Возврат в ГА ра{сКег$ .Майл для обновления пользовательского интерфейса 


15.6. Отладка сопрограмм *% 207 


В момент уничтожения пользовательского интерфейса задание автомати- 
чески будет отменено. 

Последние версии компонентов архитектуры Апаго1А предлагают дополни- 
тельные области видимости, такие как \у1еиМоде\5соре, которые автоматически 
отменяют задания при очистке \АеиМоде\1. Это - часть библиотеки Апаго!а КТХ, 
поэтому, чтобы воспользоваться этими возможностями, нужно добавить соот- 
ветствующую зависимость в файл сборки: 

Черепдепс\е$ { 


// ... как и прежде... 
1тр\етепфа{1оп «апаго\ах. 1\Ресус\е: 11Ресус\е-у\емтоде1.-Кёх:х.х.х» 


Эта строка добавит свойство \у1еиМоде\5соре, которое можно использовать для 
запуска сопрограмм с любым диспетчером. 


153.6. ОтлаАДКА СОПРОГРАММ 


Задача 
Получить больше информации о выполнении сопрограммы. 


Решение 
Запустить программу в УМ с флагом -ОКолх. согои пез .ЧеБчд. 


Обсуждение 


Отладка асинхронных программ всегда была сложной задачей, потому что 
они могут выполнять сразу несколько операций. К счастью, библиотека сопро- 
грамм включает простую в использовании поддержку отладки. 

Чтобы запустить сопрограмму в режиме отладки (под управлением ]УМ), ис- 
пользуйте системное свойство Ко 1Алпх.согоц пез .деБчд. 


Как вариант можно включить отладку с помощью флага -еа в ко- 
мандной строке ]ауа. 


В режиме отладки каждой запущенной сопрограмме присваивается уни- 
кальное имя. В примере 13.5, повторно воспроизведенном ниже для удобства, 
параллельно с основным потоком запускаются две сопрограммы: 


зизреп4 Фип гефг1еуе1(иг1: 5%г4п9) = согои 1 пебсоре { 
азупс(О1раесвег$.10) { 
рглп п(“Вефг\еу1па Чафа оп ${ТВгеад. сиггеп&ТАгеа4() .пате}”) 
Че\ау(1001) 
“азупсВе$и1+5” 
}.ама\е() 
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зизреп4 Фип гефг\еуе2 (иг1: 5%г4пд) = 
маЕНСопеехЕ (015раесвег$.10) { 
ргп лп(“Вефг\е\у1па Чдафа оп ${ТВгеа4. сиггеп{ТВгеа4() .пате}”) 
е\ау(1001) 
“итЕАСопсех{Вези 1+5” 


Г 


Рип пафп() = гипВТосКАп9<ИУп\+> { 
уа1 гези1{1 = гефгле\уе1 (“имм.туз1е. сом”) 
уа1 гези1{2 = гефгле\уе2 (“имм.туз1е. сом”) 
ргАп п (“рглп пд гези\ оп ${ТВгеа4. сиггепТБгеа9().паме} $гези\{1”) 
ргАп п(“рглп пд гези\е оп ${ТВгеа4. сиггепТБгеа9().паме} $гези\{2”) 


Если выполнить эту программу с флагом -ОКоАпх. согоц пез .4еБид, она вы- 
ведет: 
Вефглеу1пд Чафа оп БеРац {О\ра{сНег-могКег-1 @согочлпе#1 
Вефгле\у1пд Чафа оп Бега {О\5рафсНег-могКег-1 @согоч\пе#2 


ргАпЕ1пд гези1Е оп мафп @согои{пе#1 итЕСопеех{Вези {$ 
рг\ппд гези\ оп мафп @согои{пе#1 азупсВе$и11$ 


Каждая сопрограмма получила уникальновимя (@согоц\пе#1 и т. д.), которое 
отображается как часть имени потока. 

Иногда это может пригодиться, но чаще’бывает желательно определить 
свои имена для сопрограмм. Для этой цели библиотека Кот предлагает 
класс СогоиАпемате. Конструктор СогоцлпеМате создает элемент контекста, кото- 
рый можно использовать в качестве имени потока выполнения, как показано 
в примере 13.15. 


Пример 13.15. Именование сопрограмм 


зизреп4 Фип гефг4еуе1(иг1: 5%г4пд) = согоиТпе$соре { 
азупс(О\Араесвег$.10 + СогоцЕАпеМаме(“а5упс”)) { ® 
// ... как и прежде ... 
}.ама\е() 
} 


зизреп4 Фип гефг\еуе2 (иг1: 5%г4пд) = 
ма ЕАСопеех* (О\зраесНег$.10 + СогоцЕАпеМаме (“и ЕРСопеехЕ”)) { ® 
// ... как и прежде ... 


} 


© Добавляет имя сопрограммы 


Вот как теперь выглядит результат выполнения этого кода: 
Вефг1е\у {пд Чдафа оп ОеРац{О15раесрег-могКег-1 @мАЕАСопехЕ#1 
Вефгле\у1пд Чафа оп БеРац\{01ра{српег-могКег-1 @азупс#2 
ргАп пд гезиу\Е оп мафп @согои{пе#1 и\ЕСопеех{Вези {$ 
ргАп пд гези\ оп мафп @согои{пе#1 азупсВе$и11$ 

Слова «азупс» и «И Соптех&» теперь отображаются как имена сопрограмм. 
Это также хороший пример использования перегруженного оператора р\и$ 
при работе с СогоипеСоп{ех+. Другой пример использования оператора р\из 
в приложениях для Апаго!а показан в рецепте 13.5. 
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ае]ау функция 197 
Реега{ез объект, реализация 
в стандартной библиотеке 134 
Р@аезае класс 141 
ерепдепс!ез, блок 
добавление стандартной библиотеки 
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ЕхесикаЫе экземпляры 148 
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реализация в стандартной 
библиотеке 159 
Вет $т$(апсеТо функция 105 
В е$тпзапсе функция 105 
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с последовательностями 112 
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Вт функция, перегрузка 112 
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свертка последовательности или 
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значение 81 
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паНуе-ппазе инструмент для 
компиляции автономных 
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приложения 26 
эта е БиПа --агу-гап, команда 54 
Ста е, сборка 
добавление плагина Кот для 
Стооуу 29 
добавление плагина Кот для 
Стооуу (синтаксис Ко 1) 32 
добавление плагина Кот для 
Стооуу (старый синтаксис) 29 
Стае сборки 
использование плагина Кот 
(Стооуу О$Г) в проектах 
для Апагоа 30 
Стае файл сборки 
добавление плагина 
Ко т-зрите 186 
Стобуу РГ, для Сгае, 
плагин Кот 350 
Сзоп.Яот]зоп функция 140 
Сзоп().от]зот функция 127 
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в классах данных 148 
в классе Ко{пУег$1оп 164 
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сгенерированная 
в Пе] ШЕА 75 
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со значением пи 190 
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ИНапк функция 96 
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шПпе модификатор 138 
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на свойства 72, 
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Тауа 


добавление перегруженных методов 


для вызова из 41 
добавление признака поддержки 
пи| 40 
компиляция проектов с кодом 
на Ко и на ]ауа 36 
]ауа1о.ЕПе класс 160 
}ауа-Пгагу, плагин 34 
Тауа Рег$1з{епсе АРТ (]РА), 
использование с классами 
данных 188 
}ауа.и.сопсиггепе.Ехесиког5ег\се 
класс 202, 
лсетет, репозиторий 34 
лот функция 204 
]ЗОМ 172 
преобразование в экземпляры 
классов 126 
создание ассоциативного 
массива из 159 
пи 4$Ге${$ класс 
тестирование }ауа.и 1.115 145 
ап 5 
ЛОпи514$Те$($ класс 146 
пи 5 
аззе АП принимает список 
аргументов переменной длины 
с экземплярами ЕхесшаЫе 148 


использование классов данных 
для параметризации тестов 154 
параметризованные 
и динамические тесты 151 
ллой-р!аогт.ргорегЧез 
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компиляция проектов с кодом 
на Кой и на ]ауа 36 
перегруженные конструкторы 43 
Ко тс-мт, команда 
для компиляции сценариев 27 
Ко тс-5сИре, команда 26 
Кот О$Т, для Ста е 141 
Ко т-}ра плагин 188 
сущности, настроенные в 189 
Ко т-ут плагин 187 
Ко т-зрите плагин 186, 188 
Ко тУег$1юоп класс 74, 163 
сравнение экземпляров 164 
Ко тх-согоитез-апаго1а 
зависимость 201 
Ко шх.согои тез.аеБи® системное 
свойство 207 


Е 
1а(ешй уаг свойства 190 
1а(ешк и [а7у, сравнение 75 
1а{ет® модификатор, отложенная 
инициализация 70 
1а{еш® модификатор, используется 
для задержки инициализации 146 
1аипсЬ функция 195 
возвращает ссылку ]об 204 
добавление диспетчера 200 
ГатуТтеаа5ае1уМоде 132, 153 
1ату функция-делегат 67 
инициализация свойств по мере 
необходимости 132 
1её функция 124 
использование с временными 
переменными 125 
Гесуе.РЕВ_СГА$$ 153 
ГлокеаГА${ класс 93 
1$ОЕфункция 92 
ГосааеРтоэтез1опКегабог 
класс 109 
ГосаШа{еРгоетез1оп класс 109 
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тат, функция 20 
та]ог.путог.райсЬ версия 163 
тарОЁ функция 92 
Мауеп 

сборка исходного кода на Кот 35 
теазигеМапоТите функция 174 
теазигеТитемИ $ функция 174, 175 
тти$ функция 69 
тши(а ег! 1$ функция 147 


М 

пем1хедТЬгеааРоо]Соткех+ функция 
(устаревшая) 201 

пемзт&еТЬгеаЯСогиехе функция 
(устаревшая) 201 

пехИт{Е функция 179 

перегруженные версии 179 

пех{Рите функция 114, 115 

пех{Е функция 109 

по-аге плагин 188 

Мо те класс 78 

М№МоИтрететеЯ Еггог 
исключение 80, 178 

Мой\иПУаг класс 135, 141 

по Ми функция 135, 141 
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ОБзегуаеРгореку класс 137 
озегуае функция 155 

оЁ метод, класс Атеитеп($ 153 
Ореп МоНЁу служба 171 

ореп ключевое слово 186 
орегасог ключевое слово 69, 173 
ОрНопа[<Т> класс (]ауа) 98 
оге.этае.ар!.РгодесЕ класс 141 
ог оператор 53 
Оифи5неат\УЛКег 161 


Р 
Раш класс 66 
создание экземпляров с помощью 
функции то 56 
рагаПе] функция 175 
р!ие1тз, блок 
добавление плагина КоЙш 
для Сгае 30 
должен следовать первым в сборках 
Ста е 34 
р!а$ оператор в Кот 46 


раз функция 69 

Рош{ класс, ипагтуМти$ 
метод 68 

ром’ функция 49 

ритезГез$ТВап функция 116 

РгоуесЕ класс 141 


К 
Вапот класс 179 
объявленные методы 179 
реализация 179 
теааВу(ез функция 160 
Веайег класс, изе[лпез метод 158 
теаалпез функция 160 
Веа@ОтуРгореку интерфейс 135 
теа4Техе функция 160 
Веа@\КеРторегу интерфейс 155, 138 
тедисе функция 84 
сравнение с Ю1а 84 
тереа{ функция 165, 204 
терасе функция, использование 
с регулярными выражениями 167 
герозКо11ез, блок 
добавление плагина КоЙш 
для Сга@е 30 
гапВюоскте функция 194, 197 
использование 194 
ВиппаЫе интерфейс 177 
ВипИше класс 76 
гоп метод, класса Тбгеаа 177 
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зауе, функция 122 
зедиепсе О! функция 113 
зеОЁ функция 92 
3Ы функция 51 
г функция 51 
зри(аомтМом метод 203 
зри(аомт метод 203 
зопеа\/ир функция 103 
бргте фреймворк 185 
открытие классов для распгирения 
фреймворком 5рипе 185 
хранимые классы данных Ко 1 188 
зас модификатор 145 
Э(теат интерфейс 158 
Эриие$КЕ класс 169 
зирег, вызов родительского 
конструктора в ]ауа 45 
бу$ет.ситепТниеМИИ$ метод 175 
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т 
{аПгес ключевое слово 87 
{акем/р!Пе функция 115, 116 
{аКе функция 116 
ТезИпз(апсе.ГИесуе.РЕВ_СГА$$ 155 
ФепВу функция 103 
(15? аргумент и возвращаемое 
значение функции арру 121 
Фгеаа функция 175 
Фгом’з ключевое слово 183 
Титеои(СапсеЙаНопЕхсерНоп 
исключение 205 
тез функция 69 
{оВтагубите функция 47 
{оВуе, функция 46 
{оСраг, функция 46 
{оПоцЫе(), функция 46 
ТОРО функция 178 
{оЕоаО, функция 46 
{от функция 46 
{011$ функция 94 
{оГоп8(), функция 46 
{оМар функция 94 
{обеЁ функция 94 
{обпот, функция 46 
{обише функция 47, 63 
класс Ко тУег$1оп 165 
класс Зеите$КЕ 169 
Тир!е класс 66 
{у-\Л-гезоигсез конструкция 
(ауа) 157 


у 

ипагуМти$ метод в классе РошЕ 68 

Опт а17еаРторекуАссезЕхсерНоп 
исключение 72 

изеМпез функция 158, 160 


изе функция 158, 203 
запись с помощью 161 
сигнатура в интерфейсе 

Созеае 159 

и$Бг функция 51 


№ 
уа| ключевое слово 62 
соп${ и уа|, различия 59 
уаг ключевое слово 62 
1а(ети модификатор, отложенная 
инициализация 71 
уеюаЫе функция 155 


М/ 
УТеп оператор 
исчерпывающий 165 
мТеп свойство (аннотация 
@Моппий) 41 
улпдомед функция 99 
мИСотех( функция 
добавление диспетчера 200 
замена комбинации азупс/амай 199 
уифтаех функция 91 
мифТилеоц(ОтМий функция 206 
мифТилеоц( функция 205 
улкеВуез функция 161 
улКег функция 161 
утКеТех( функция 161 


Хх 
хог оператор 53 


У 
уе!аАП функция 118 
уе! функция 118 
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лучше видеть ночью. Цепкие задние лапы и хвост помогают кинкажу вести 
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Текст книги набран шрифтом АдоБе Мпуоп Рго; текст заголовков — шрифтом 
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